thread camera_spec through tool registry

waldoctl's ToolSpec now carries an optional camera_spec (default camera
attached to a tool) plus a user-tweakable ToolRuntimeSettings override
layer. ToolConfig grows a matching optional camera_spec field and
_build_tools passes it into each tool constructor; tools that omit it
behave as before (effective_camera_device returns None unless the user
sets a runtime override).

Lets the frontend stream a tool-mounted camera feed only when the active
tool has one configured, and lets the user remap the device per session
(e.g. virtual /dev/videoN for AI-annotation pipelines) without
reinstalling the backend.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: Jepson2k

parol6/robot.py

@@ -473,6 +473,7 @@ def _build_tools() -> _ToolsCollection:
             meshes=cfg.meshes,
             motions=cfg.motions,
             variants=cfg.variants,
+            camera_spec=cfg.camera_spec,
         )
 
         if isinstance(cfg, PneumaticGripperConfig):

parol6/tools.py

@@ -17,6 +17,7 @@
 import numpy as np
 from pinokin import se3_from_trans
 from waldoctl import (
+    CameraSpec,
     LinearMotion,
     MeshRole,
     MeshSpec,
@@ -77,6 +78,11 @@ class ToolConfig:
     meshes: tuple[MeshSpec, ...] = ()
     motions: tuple[PartMotion, ...] = ()
     variants: tuple[ToolVariant, ...] = ()
+    camera_spec: "CameraSpec | None" = None
+    """Optional camera attached to this tool. Wired through ``_build_tools``
+    into the live ``ToolSpec`` so the frontend can stream the feed when this
+    tool is active. The user can override the device per session via the
+    tool's ``runtime_settings.camera_device``."""
 
     def populate_status(self, hw: ControllerState, out: ToolStatus) -> None:
         """Fill *out* from hardware state. Override in subclasses."""