NDI discovery

docs/openapi.yaml

@@ -193,6 +193,19 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/HostConfigResponse"
+  /api/ndi/sources:
+    get:
+      tags: [Config]
+      summary: Discover NDI sources
+      description: Returns currently discoverable NDI sources for the host-config input device picker. Manual source names remain valid even when discovery returns no matches.
+      operationId: getNdiSources
+      responses:
+        "200":
+          description: Current NDI source discovery result.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/NdiSourcesResponse"
   /api/config/save:
     post:
       tags: [Config]
@@ -576,6 +589,28 @@ components:
           type: boolean
         error:
           type: string
+    NdiSourcesResponse:
+      type: object
+      properties:
+        ok:
+          type: boolean
+        error:
+          type: string
+        sources:
+          type: array
+          items:
+            $ref: "#/components/schemas/NdiSource"
+      additionalProperties: false
+    NdiSource:
+      type: object
+      properties:
+        name:
+          type: string
+          description: User-visible NDI source name, usually `MACHINE (SOURCE)`.
+        urlAddress:
+          type: string
+          description: SDK-provided URL/address for diagnostics. Saved host config still uses the source name.
+      additionalProperties: false
     HostConfig:
       type: object
       properties:
@@ -639,8 +674,10 @@ components:
           properties:
             external:
               type: boolean
+              description: DeckLink external-keyer backing field. The bundled UI exposes this together with alphaRequired as Output alpha and only writes it true for DeckLink output.
             alphaRequired:
               type: boolean
+              description: General output alpha request. When true, automatic output pixel-format selection uses an alpha-carrying system-frame format.
           additionalProperties: false
       additionalProperties: false
     RuntimeState:
@@ -725,10 +762,15 @@ components:
             keying:
               type: object
               properties:
+                outputAlpha:
+                  type: boolean
+                  description: Operator-facing derived alpha state. True when alphaRequired or the DeckLink external-keyer backing field is true.
                 external:
                   type: boolean
+                  description: DeckLink external-keyer backing field. The bundled UI exposes this together with alphaRequired as Output alpha and only writes it true for DeckLink output.
                 alphaRequired:
                   type: boolean
+                  description: General output alpha request. When true, automatic output pixel-format selection uses an alpha-carrying system-frame format.
     RuntimeStatus:
       type: object
       properties: