Make template scripts aware of stream mode

Author: tferr

src/main/java/sc/fiji/snt/SNTService.java

@@ -129,6 +129,21 @@ public boolean isActive() {
 		return SNTUtils.getInstance() != null;
 	}
 
+	/**
+	 * Gets whether SNT is currently running in Stream mode ("SNT Stream"), i.e., tethered to a
+	 * streamed dataset (N5/OME-Zarr/IMS/BDV-XML) via the Big Data Loader, with no in-core
+	 * {@code ImagePlus}/classic canvas available. Several script-facing APIs (ImagePlus-based
+	 * snapshots, ROI-based inputs, {@code SNT#rebuildDisplayCanvases()}, etc.) are not available
+	 * in this mode. Scripts can use this method to detect that and abort/adapt early.
+	 *
+	 * @return true if SNT is active and running in Stream mode; false otherwise (including when
+	 *         SNT is not running, or is running without a GUI)
+	 */
+	public boolean isStreamMode() {
+		final SNT instance = SNTUtils.getInstance();
+		return instance != null && instance.getUI() != null && instance.getUI().isStreamMode();
+	}
+
 	/**
 	 * Assigns pixel intensities at each Path node, storing them as Path values.
 	 * Assigned intensities are those of the channel and time point currently being

src/main/resources/script_templates/Neuroanatomy/Spines_and_Varicosities/Peripath_Detection_Demo.groovy

@@ -1,7 +1,7 @@
 /**
  * file:    Peripath_Detection_Demo.groovy
  * author:  Tiago Ferreira
- * version: 2026.04.09
+ * version: 2026.07.31
  * info:    Demonstrates the PeripathDetector workflow: automated detection of
  *          intensity maxima (spines, varicosities, puncta) around traced paths.
  *
@@ -21,12 +21,21 @@
 #@ SNTService snt
 
 // Ensure SNT is up-to-date and is not busy with another operation
-snt.requireVersion("5.0.7")
-if (snt.isActive() && snt.getUI() && !snt.getUI().isReady()) {
+snt.requireVersion("5.0.14")
+if (snt.isActive() && snt.getUI() && !snt.isStreamMode() && !snt.getUI().isReady()) {
     print("Please complete current operation before running this script!")
     return
 }
 
+// This demo re-initializes SNT with its own classic (in-core) demo image, which would
+// replace/reconfigure an existing Stream ("SNT Stream") session
+if (snt.isStreamMode()) {
+    snt.getUI().error("This demo requires re-initializing SNT with a classic (non-streamed) "
+            + "image, which would replace the current Stream-mode session. Please switch to "
+            + "Standard mode to run it.")
+    return
+}
+
 // 1) Load a demo image. We'll use  CIL:810: it is a cultured hippocampal
 // neuron with 3 channels: Ch1: N-caherin; Ch2: V-glut; Ch3: NMDAR. We'll
 // detect  V-glut puncta (Ch2) around a traced dendrite traced from Ch1

src/main/resources/script_templates/Neuroanatomy/Spines_and_Varicosities/Spacing_Analysis.groovy

@@ -1,7 +1,7 @@
 /**
  * file:    Spacing_Analysis.groovy
  * author:  Tiago Ferreira
- * version: 2026.04.21
+ * version: 2026.07.31
  * info:    Demonstrates how to compute geodesic (along-the-path) distances
  *          between consecutive detections from PeripathDetector. The script
  *          detects intensity maxima (varicosities, synaptic puncta, etc.)
@@ -24,8 +24,8 @@
 #@ SNTService snt
 
 // Ensure SNT is up-to-date and is not busy with another operation
-snt.requireVersion("5.0.7")
-if (snt.isActive() && snt.getUI() && !snt.getUI().isReady()) {
+snt.requireVersion("5.0.14")
+if (snt.isActive() && snt.getUI() && !snt.isStreamMode() && !snt.getUI().isReady()) {
     print("Please complete current operation before running this script!")
     return
 }
@@ -39,6 +39,15 @@ def getImageAndPaths(fileImg, fileTree) {
         for (tree in Tree.listFromFile(fileTree.getAbsolutePath()))
             paths.addAll(tree.list())
     } else {
+        // The demo re-initializes SNT with its own classic (in-core) image, which would
+        // replace/reconfigure an existing Stream ("SNT Stream") session, which is unexpected
+        if (snt.isStreamMode()) {
+            snt.getUI().error("The demo image requires re-initializing SNT with a classic "
+                    + "(non-streamed) image, which would replace the current Stream-mode "
+                    + "session. Please supply your own image/reconstruction files above, or "
+                    + "switch to Standard mode to run the demo.")
+            return Tuple.tuple(null, null)
+        }
         // demo mode: CIL:810 hippocampal neuron (Ch1: N-cadherin; Ch2: V-glut; Ch3: NMDAR)
         // see Peripath_Detection_Demo.groovy template script
         imp = snt.demoImage("cil810")
@@ -54,6 +63,9 @@ def getImageAndPaths(fileImg, fileTree) {
 }
 
 (imp, paths) = getImageAndPaths(imageFile, tracesFile)
+if (imp == null || paths == null) {
+    return
+}
 
 // 2) Fit radii. PeripathDetector uses per-node radii to define the search
 // annulus. Without fitted radii, a fallback (2x voxel size) is used