From 7fca4d74bf786384d3a65e63a443b759cb174e12 Mon Sep 17 00:00:00 2001
From: Neil Dorin <ndorin@pepperdash.com>
Date: Tue, 11 Aug 2026 14:16:56 -0600
Subject: [PATCH] feat: add IAnnotationStream interface for annotation stream
 functionality

---
 .../DeviceTypeInterfaces/IAnnotationStream.cs | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 src/PepperDash.Essentials.Core/DeviceTypeInterfaces/IAnnotationStream.cs

diff --git a/src/PepperDash.Essentials.Core/DeviceTypeInterfaces/IAnnotationStream.cs b/src/PepperDash.Essentials.Core/DeviceTypeInterfaces/IAnnotationStream.cs
new file mode 100644
index 00000000..7bef3671
--- /dev/null
+++ b/src/PepperDash.Essentials.Core/DeviceTypeInterfaces/IAnnotationStream.cs
@@ -0,0 +1,19 @@
+namespace PepperDash.Essentials.Core.DeviceTypeInterfaces;
+
+    /// <summary>
+    /// Defines minimum functionality for a device that can provide an annotation stream.
+    /// </summary>
+    public interface IAnnotationStream
+    {
+        /// <summary>
+        /// Starts the annotation stream.
+        /// </summary>
+        /// <param name="streamIdx">The index of the annotation stream to start.</param>
+        bool StartAnnotationForStream(ushort streamIdx);
+        
+        /// <summary>
+        /// Stops the annotation stream.
+        /// </summary>
+        /// <param name="streamIdx">The index of the annotation stream to stop.</param>
+        bool StopAnnotationForStream(ushort streamIdx);
+    }