@stinkycomputing/sesame-api-client 1.10.0-alpha.2 → 1.10.0-alpha.4

package/dist/proto/api.d.ts

@@ -6690,6 +6690,9 @@ export namespace sesame {
 
                 /** TransportControlRequest value */
                 value?: (sesame.v1.common.IPropValue|null);
+
+                /** TransportControlRequest sourceId */
+                sourceId?: (string|null);
             }
 
             /** Represents a TransportControlRequest. */
@@ -6707,6 +6710,9 @@ export namespace sesame {
                 /** TransportControlRequest value. */
                 public value?: (sesame.v1.common.IPropValue|null);
 
+                /** TransportControlRequest sourceId. */
+                public sourceId: string;
+
                 /**
                  * Creates a new TransportControlRequest instance using the specified properties.
                  * @param [properties] Properties to set
@@ -10568,6 +10574,103 @@ export namespace sesame {
                 public static getTypeUrl(typeUrlPrefix?: string): string;
             }
 
+            /** Properties of a TransportStatus. */
+            interface ITransportStatus {
+
+                /** TransportStatus sources */
+                sources?: (sesame.v1.status.ITransportEvent[]|null);
+            }
+
+            /** Represents a TransportStatus. */
+            class TransportStatus implements ITransportStatus {
+
+                /**
+                 * Constructs a new TransportStatus.
+                 * @param [properties] Properties to set
+                 */
+                constructor(properties?: sesame.v1.status.ITransportStatus);
+
+                /** TransportStatus sources. */
+                public sources: sesame.v1.status.ITransportEvent[];
+
+                /**
+                 * Creates a new TransportStatus instance using the specified properties.
+                 * @param [properties] Properties to set
+                 * @returns TransportStatus instance
+                 */
+                public static create(properties?: sesame.v1.status.ITransportStatus): sesame.v1.status.TransportStatus;
+
+                /**
+                 * Encodes the specified TransportStatus message. Does not implicitly {@link sesame.v1.status.TransportStatus.verify|verify} messages.
+                 * @param message TransportStatus message or plain object to encode
+                 * @param [writer] Writer to encode to
+                 * @returns Writer
+                 */
+                public static encode(message: sesame.v1.status.ITransportStatus, writer?: $protobuf.Writer): $protobuf.Writer;
+
+                /**
+                 * Encodes the specified TransportStatus message, length delimited. Does not implicitly {@link sesame.v1.status.TransportStatus.verify|verify} messages.
+                 * @param message TransportStatus message or plain object to encode
+                 * @param [writer] Writer to encode to
+                 * @returns Writer
+                 */
+                public static encodeDelimited(message: sesame.v1.status.ITransportStatus, writer?: $protobuf.Writer): $protobuf.Writer;
+
+                /**
+                 * Decodes a TransportStatus message from the specified reader or buffer.
+                 * @param reader Reader or buffer to decode from
+                 * @param [length] Message length if known beforehand
+                 * @returns TransportStatus
+                 * @throws {Error} If the payload is not a reader or valid buffer
+                 * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                 */
+                public static decode(reader: ($protobuf.Reader|Uint8Array), length?: number): sesame.v1.status.TransportStatus;
+
+                /**
+                 * Decodes a TransportStatus message from the specified reader or buffer, length delimited.
+                 * @param reader Reader or buffer to decode from
+                 * @returns TransportStatus
+                 * @throws {Error} If the payload is not a reader or valid buffer
+                 * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                 */
+                public static decodeDelimited(reader: ($protobuf.Reader|Uint8Array)): sesame.v1.status.TransportStatus;
+
+                /**
+                 * Verifies a TransportStatus message.
+                 * @param message Plain object to verify
+                 * @returns `null` if valid, otherwise the reason why it is not
+                 */
+                public static verify(message: { [k: string]: any }): (string|null);
+
+                /**
+                 * Creates a TransportStatus message from a plain object. Also converts values to their respective internal types.
+                 * @param object Plain object
+                 * @returns TransportStatus
+                 */
+                public static fromObject(object: { [k: string]: any }): sesame.v1.status.TransportStatus;
+
+                /**
+                 * Creates a plain object from a TransportStatus message. Also converts values to other types if specified.
+                 * @param message TransportStatus
+                 * @param [options] Conversion options
+                 * @returns Plain object
+                 */
+                public static toObject(message: sesame.v1.status.TransportStatus, options?: $protobuf.IConversionOptions): { [k: string]: any };
+
+                /**
+                 * Converts this TransportStatus to JSON.
+                 * @returns JSON object
+                 */
+                public toJSON(): { [k: string]: any };
+
+                /**
+                 * Gets the default type url for TransportStatus
+                 * @param [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+                 * @returns The default type url
+                 */
+                public static getTypeUrl(typeUrlPrefix?: string): string;
+            }
+
             /** Properties of a MetadataEvent. */
             interface IMetadataEvent {
 

package/dist/proto/api.js

@@ -18643,6 +18643,7 @@ export const sesame = $root.sesame = (() => {
                  * @interface ITransportControlRequest
                  * @property {sesame.v1.sources.SourceTransportCommandType|null} [cmdType] TransportControlRequest cmdType
                  * @property {sesame.v1.common.IPropValue|null} [value] TransportControlRequest value
+                 * @property {string|null} [sourceId] TransportControlRequest sourceId
                  */
 
                 /**
@@ -18676,6 +18677,14 @@ export const sesame = $root.sesame = (() => {
                  */
                 TransportControlRequest.prototype.value = null;
 
+                /**
+                 * TransportControlRequest sourceId.
+                 * @member {string} sourceId
+                 * @memberof sesame.v1.sources.TransportControlRequest
+                 * @instance
+                 */
+                TransportControlRequest.prototype.sourceId = "";
+
                 /**
                  * Creates a new TransportControlRequest instance using the specified properties.
                  * @function create
@@ -18704,6 +18713,8 @@ export const sesame = $root.sesame = (() => {
                         writer.uint32(/* id 1, wireType 0 =*/8).int32(message.cmdType);
                     if (message.value != null && Object.hasOwnProperty.call(message, "value"))
                         $root.sesame.v1.common.PropValue.encode(message.value, writer.uint32(/* id 2, wireType 2 =*/18).fork()).ldelim();
+                    if (message.sourceId != null && Object.hasOwnProperty.call(message, "sourceId"))
+                        writer.uint32(/* id 3, wireType 2 =*/26).string(message.sourceId);
                     return writer;
                 };
 
@@ -18748,6 +18759,10 @@ export const sesame = $root.sesame = (() => {
                                 message.value = $root.sesame.v1.common.PropValue.decode(reader, reader.uint32());
                                 break;
                             }
+                        case 3: {
+                                message.sourceId = reader.string();
+                                break;
+                            }
                         default:
                             reader.skipType(tag & 7);
                             break;
@@ -18811,6 +18826,9 @@ export const sesame = $root.sesame = (() => {
                         if (error)
                             return "value." + error;
                     }
+                    if (message.sourceId != null && message.hasOwnProperty("sourceId"))
+                        if (!$util.isString(message.sourceId))
+                            return "sourceId: string expected";
                     return null;
                 };
 
@@ -18907,6 +18925,8 @@ export const sesame = $root.sesame = (() => {
                             throw TypeError(".sesame.v1.sources.TransportControlRequest.value: object expected");
                         message.value = $root.sesame.v1.common.PropValue.fromObject(object.value);
                     }
+                    if (object.sourceId != null)
+                        message.sourceId = String(object.sourceId);
                     return message;
                 };
 
@@ -18926,11 +18946,14 @@ export const sesame = $root.sesame = (() => {
                     if (options.defaults) {
                         object.cmdType = options.enums === String ? "SOURCE_TRANSPORT_CMD_UNSPECIFIED" : 0;
                         object.value = null;
+                        object.sourceId = "";
                     }
                     if (message.cmdType != null && message.hasOwnProperty("cmdType"))
                         object.cmdType = options.enums === String ? $root.sesame.v1.sources.SourceTransportCommandType[message.cmdType] === undefined ? message.cmdType : $root.sesame.v1.sources.SourceTransportCommandType[message.cmdType] : message.cmdType;
                     if (message.value != null && message.hasOwnProperty("value"))
                         object.value = $root.sesame.v1.common.PropValue.toObject(message.value, options);
+                    if (message.sourceId != null && message.hasOwnProperty("sourceId"))
+                        object.sourceId = message.sourceId;
                     return object;
                 };
 
@@ -29341,6 +29364,232 @@ export const sesame = $root.sesame = (() => {
                 return TransportEvent;
             })();
 
+            status.TransportStatus = (function() {
+
+                /**
+                 * Properties of a TransportStatus.
+                 * @memberof sesame.v1.status
+                 * @interface ITransportStatus
+                 * @property {Array.<sesame.v1.status.ITransportEvent>|null} [sources] TransportStatus sources
+                 */
+
+                /**
+                 * Constructs a new TransportStatus.
+                 * @memberof sesame.v1.status
+                 * @classdesc Represents a TransportStatus.
+                 * @implements ITransportStatus
+                 * @constructor
+                 * @param {sesame.v1.status.ITransportStatus=} [properties] Properties to set
+                 */
+                function TransportStatus(properties) {
+                    this.sources = [];
+                    if (properties)
+                        for (let keys = Object.keys(properties), i = 0; i < keys.length; ++i)
+                            if (properties[keys[i]] != null)
+                                this[keys[i]] = properties[keys[i]];
+                }
+
+                /**
+                 * TransportStatus sources.
+                 * @member {Array.<sesame.v1.status.ITransportEvent>} sources
+                 * @memberof sesame.v1.status.TransportStatus
+                 * @instance
+                 */
+                TransportStatus.prototype.sources = $util.emptyArray;
+
+                /**
+                 * Creates a new TransportStatus instance using the specified properties.
+                 * @function create
+                 * @memberof sesame.v1.status.TransportStatus
+                 * @static
+                 * @param {sesame.v1.status.ITransportStatus=} [properties] Properties to set
+                 * @returns {sesame.v1.status.TransportStatus} TransportStatus instance
+                 */
+                TransportStatus.create = function create(properties) {
+                    return new TransportStatus(properties);
+                };
+
+                /**
+                 * Encodes the specified TransportStatus message. Does not implicitly {@link sesame.v1.status.TransportStatus.verify|verify} messages.
+                 * @function encode
+                 * @memberof sesame.v1.status.TransportStatus
+                 * @static
+                 * @param {sesame.v1.status.ITransportStatus} message TransportStatus message or plain object to encode
+                 * @param {$protobuf.Writer} [writer] Writer to encode to
+                 * @returns {$protobuf.Writer} Writer
+                 */
+                TransportStatus.encode = function encode(message, writer) {
+                    if (!writer)
+                        writer = $Writer.create();
+                    if (message.sources != null && message.sources.length)
+                        for (let i = 0; i < message.sources.length; ++i)
+                            $root.sesame.v1.status.TransportEvent.encode(message.sources[i], writer.uint32(/* id 1, wireType 2 =*/10).fork()).ldelim();
+                    return writer;
+                };
+
+                /**
+                 * Encodes the specified TransportStatus message, length delimited. Does not implicitly {@link sesame.v1.status.TransportStatus.verify|verify} messages.
+                 * @function encodeDelimited
+                 * @memberof sesame.v1.status.TransportStatus
+                 * @static
+                 * @param {sesame.v1.status.ITransportStatus} message TransportStatus message or plain object to encode
+                 * @param {$protobuf.Writer} [writer] Writer to encode to
+                 * @returns {$protobuf.Writer} Writer
+                 */
+                TransportStatus.encodeDelimited = function encodeDelimited(message, writer) {
+                    return this.encode(message, writer).ldelim();
+                };
+
+                /**
+                 * Decodes a TransportStatus message from the specified reader or buffer.
+                 * @function decode
+                 * @memberof sesame.v1.status.TransportStatus
+                 * @static
+                 * @param {$protobuf.Reader|Uint8Array} reader Reader or buffer to decode from
+                 * @param {number} [length] Message length if known beforehand
+                 * @returns {sesame.v1.status.TransportStatus} TransportStatus
+                 * @throws {Error} If the payload is not a reader or valid buffer
+                 * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                 */
+                TransportStatus.decode = function decode(reader, length, error) {
+                    if (!(reader instanceof $Reader))
+                        reader = $Reader.create(reader);
+                    let end = length === undefined ? reader.len : reader.pos + length, message = new $root.sesame.v1.status.TransportStatus();
+                    while (reader.pos < end) {
+                        let tag = reader.uint32();
+                        if (tag === error)
+                            break;
+                        switch (tag >>> 3) {
+                        case 1: {
+                                if (!(message.sources && message.sources.length))
+                                    message.sources = [];
+                                message.sources.push($root.sesame.v1.status.TransportEvent.decode(reader, reader.uint32()));
+                                break;
+                            }
+                        default:
+                            reader.skipType(tag & 7);
+                            break;
+                        }
+                    }
+                    return message;
+                };
+
+                /**
+                 * Decodes a TransportStatus message from the specified reader or buffer, length delimited.
+                 * @function decodeDelimited
+                 * @memberof sesame.v1.status.TransportStatus
+                 * @static
+                 * @param {$protobuf.Reader|Uint8Array} reader Reader or buffer to decode from
+                 * @returns {sesame.v1.status.TransportStatus} TransportStatus
+                 * @throws {Error} If the payload is not a reader or valid buffer
+                 * @throws {$protobuf.util.ProtocolError} If required fields are missing
+                 */
+                TransportStatus.decodeDelimited = function decodeDelimited(reader) {
+                    if (!(reader instanceof $Reader))
+                        reader = new $Reader(reader);
+                    return this.decode(reader, reader.uint32());
+                };
+
+                /**
+                 * Verifies a TransportStatus message.
+                 * @function verify
+                 * @memberof sesame.v1.status.TransportStatus
+                 * @static
+                 * @param {Object.<string,*>} message Plain object to verify
+                 * @returns {string|null} `null` if valid, otherwise the reason why it is not
+                 */
+                TransportStatus.verify = function verify(message) {
+                    if (typeof message !== "object" || message === null)
+                        return "object expected";
+                    if (message.sources != null && message.hasOwnProperty("sources")) {
+                        if (!Array.isArray(message.sources))
+                            return "sources: array expected";
+                        for (let i = 0; i < message.sources.length; ++i) {
+                            let error = $root.sesame.v1.status.TransportEvent.verify(message.sources[i]);
+                            if (error)
+                                return "sources." + error;
+                        }
+                    }
+                    return null;
+                };
+
+                /**
+                 * Creates a TransportStatus message from a plain object. Also converts values to their respective internal types.
+                 * @function fromObject
+                 * @memberof sesame.v1.status.TransportStatus
+                 * @static
+                 * @param {Object.<string,*>} object Plain object
+                 * @returns {sesame.v1.status.TransportStatus} TransportStatus
+                 */
+                TransportStatus.fromObject = function fromObject(object) {
+                    if (object instanceof $root.sesame.v1.status.TransportStatus)
+                        return object;
+                    let message = new $root.sesame.v1.status.TransportStatus();
+                    if (object.sources) {
+                        if (!Array.isArray(object.sources))
+                            throw TypeError(".sesame.v1.status.TransportStatus.sources: array expected");
+                        message.sources = [];
+                        for (let i = 0; i < object.sources.length; ++i) {
+                            if (typeof object.sources[i] !== "object")
+                                throw TypeError(".sesame.v1.status.TransportStatus.sources: object expected");
+                            message.sources[i] = $root.sesame.v1.status.TransportEvent.fromObject(object.sources[i]);
+                        }
+                    }
+                    return message;
+                };
+
+                /**
+                 * Creates a plain object from a TransportStatus message. Also converts values to other types if specified.
+                 * @function toObject
+                 * @memberof sesame.v1.status.TransportStatus
+                 * @static
+                 * @param {sesame.v1.status.TransportStatus} message TransportStatus
+                 * @param {$protobuf.IConversionOptions} [options] Conversion options
+                 * @returns {Object.<string,*>} Plain object
+                 */
+                TransportStatus.toObject = function toObject(message, options) {
+                    if (!options)
+                        options = {};
+                    let object = {};
+                    if (options.arrays || options.defaults)
+                        object.sources = [];
+                    if (message.sources && message.sources.length) {
+                        object.sources = [];
+                        for (let j = 0; j < message.sources.length; ++j)
+                            object.sources[j] = $root.sesame.v1.status.TransportEvent.toObject(message.sources[j], options);
+                    }
+                    return object;
+                };
+
+                /**
+                 * Converts this TransportStatus to JSON.
+                 * @function toJSON
+                 * @memberof sesame.v1.status.TransportStatus
+                 * @instance
+                 * @returns {Object.<string,*>} JSON object
+                 */
+                TransportStatus.prototype.toJSON = function toJSON() {
+                    return this.constructor.toObject(this, $protobuf.util.toJSONOptions);
+                };
+
+                /**
+                 * Gets the default type url for TransportStatus
+                 * @function getTypeUrl
+                 * @memberof sesame.v1.status.TransportStatus
+                 * @static
+                 * @param {string} [typeUrlPrefix] your custom typeUrlPrefix(default "type.googleapis.com")
+                 * @returns {string} The default type url
+                 */
+                TransportStatus.getTypeUrl = function getTypeUrl(typeUrlPrefix) {
+                    if (typeUrlPrefix === undefined) {
+                        typeUrlPrefix = "type.googleapis.com";
+                    }
+                    return typeUrlPrefix + "/sesame.v1.status.TransportStatus";
+                };
+
+                return TransportStatus;
+            })();
+
             status.MetadataEvent = (function() {
 
                 /**

package/dist/sesame-wire-protocol.d.ts

@@ -30,7 +30,7 @@ export type ParsedDataFrame = {
 } | {
     dataType: 'transport-status';
     trackName: string;
-    event: sesame.v1.status.TransportEvent;
+    status: sesame.v1.status.TransportStatus;
 } | {
     dataType: 'audio-state';
     trackName: string;
@@ -43,6 +43,26 @@ export type ParsedDataFrame = {
     dataType: 'audio-control';
     trackName: string;
     request: sesame.v1.audio.AudioControlRequest;
+} | {
+    dataType: 'output-control';
+    trackName: string;
+    request: sesame.v1.outputs.OutputControlRequest;
+} | {
+    dataType: 'source-control';
+    trackName: string;
+    request: sesame.v1.sources.SourceControlRequest;
+} | {
+    dataType: 'output-status';
+    trackName: string;
+    status: sesame.v1.outputs.OutputStatus;
+} | {
+    dataType: 'source-status';
+    trackName: string;
+    status: sesame.v1.sources.SourceStatus;
+} | {
+    dataType: 'engine-status';
+    trackName: string;
+    status: sesame.v1.status.Status;
 } | {
     dataType: 'binary';
     trackName: string;
@@ -113,17 +133,21 @@ export declare function buildAudioControlFrame(trackName: string, request: sesam
  * Build a ready-to-send wire frame carrying a `TransportControlRequest`.
  *
  * Send this over a WebSocket source connection to queue a playback command
- * on the server. The target source is resolved from the server's routing table.
+ * on the server. The track must be bound to the reserved target `sources`
+ * and the request names the source in `sourceId`.
  *
  * @example
  * ```ts
  * const bytes = buildTransportControlFrame('my-control-track', {
+ *   sourceId: 'file-1',
  *   cmdType: sesame.v1.sources.SourceTransportCommandType.SOURCE_TRANSPORT_CMD_PLAY,
  * });
  * ws.send(bytes);
  * ```
  */
-export declare function buildTransportControlFrame(trackName: string, request: sesame.v1.sources.ITransportControlRequest): Uint8Array;
+export declare function buildTransportControlFrame(trackName: string, request: sesame.v1.sources.ITransportControlRequest & {
+    sourceId: string;
+}): Uint8Array;
 /**
  * Build a ready-to-send wire frame carrying a `SourceControlRequest`.
  *
@@ -144,6 +168,10 @@ export declare function buildTransportControlFrame(trackName: string, request: s
  * ```
  */
 export declare function buildSourceControlFrame(trackName: string, request: sesame.v1.sources.ISourceControlRequest): Uint8Array;
+/**
+ * Build a DATA_TYPE_OUTPUT_CONTROL frame: start or stop the output named by `request.id`.
+ */
+export declare function buildOutputControlFrame(trackName: string, request: sesame.v1.outputs.IOutputControlRequest): Uint8Array;
 /**
  * Build a ready-to-send wire frame carrying raw binary data.
  *

package/dist/sesame-wire-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sesame-wire-protocol.d.ts","sourceRoot":"","sources":["../src/sesame-wire-protocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sesame-wire-protocol.d.ts","sourceRoot":"","sources":["../src/sesame-wire-protocol.ts"],"names":[],"mappings":"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"}

package/docs/protocol-reference.md

@@ -1288,13 +1288,14 @@ Request to add a new output.
 Runtime start/stop of an output stream. Only valid for SRT outputs configured
 with SRT_STREAM_CONTROL_MANUAL; rejected otherwise.
 When received over the wire protocol (DATA_TYPE_OUTPUT_CONTROL) the target
-output is resolved from the track's metadata binding and `id` is ignored, so
-a remote client can only control the output its track is bound to.
+output is resolved from the track's metadata binding: a track bound to one
+output can only control that output and `id` is ignored; a track bound to
+the reserved target `outputs` controls the output named in `id`.
 
 
 | Field | Type | Description |
 |-------|------|-------------|
-| `id` |  string | Output ID (command API only; ignored on bound wire tracks) |
+| `id` |  string | Output ID (command API, and wire tracks bound to the reserved target `outputs`) |
 | `action` |  OutputControlAction | Action to perform |
 
 
@@ -1815,6 +1816,7 @@ Video preprocessing step type.
 | 0 | `PREPROCESS_STEP_UNSPECIFIED` | Unspecified (invalid) |
 | 2 | `PREPROCESS_STEP_CHROMA_KEY` | Chroma key |
 | 3 | `PREPROCESS_STEP_BLUR` | Blur effect |
+| 4 | `PREPROCESS_STEP_COLOR_CORRECT` | Color correction (exposure, contrast, saturation, hue, lift/gamma/gain) |
 
 
 ### ScopeMode
@@ -2111,6 +2113,28 @@ Defines how a source is created and configured.
 | `scope` |  ScopeSourceConfig | SOURCE_TYPE_SCOPE |
 
 
+### SourceControlRequest
+
+Payload for DATA_TYPE_SOURCE_CONTROL frames (transport → source).
+
+The target source is resolved server-side from the MetadataRouter binding
+configured for this source track. A track bound to one source can only
+control that source and `source_id` is ignored. A track bound to the
+reserved target `sources` controls any source and must name it in
+`source_id`. Mirrors SourceStatus.video_processors: take the status, copy
+the processor id and the parameter ids you want to change, and set the new
+values. Updates are queued as property sets and applied together on the
+next engine tick.
+
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `video_processors` | repeated VideoProcessorControlRequest | Video processor parameter updates |
+| `audio_level` | optional float | New source audio level (0.0-1.0) |
+| `reset_processors` | repeated string | Video processor instance IDs to reset to their defaults (applied before video_processors) |
+| `source_id` |  string | Target source; used only when the track is bound to the reserved target `sources` |
+
+
 ### SourceMetadataEvent
 
 Source metadata transport event notification.
@@ -2171,6 +2195,7 @@ Source status information.
 | `decode_timing` |  sesame.v1.status.FrameTiming | Decode timing stats |
 | `video_buf_avg` |  double | Average video buffer level |
 | `srt_stats` | optional sesame.v1.status.SRTReceiveStatistics | SRT stats (if SRT source) |
+| `video_processors` | repeated VideoProcessor | Video processors with their current parameter values |
 
 
 ### SourceTransportCommand
@@ -2242,17 +2267,17 @@ between items inside the playlist.
 
 Payload for DATA_TYPE_TRANSPORT_CONTROL frames (transport → server).
 
-The target source ID is NOT included here — it is resolved server-side from
-the MetadataRouter binding configured for this source track. This mirrors
-TransportEvent: to build a control message, copy cmd_type and value from
-the desired SourceTransportCommandType. The server will only apply commands
-to the source the track is bound to; it cannot control arbitrary sources.
+Transport control tracks are bound to the reserved target `sources`, so one
+track reaches every transportable source, including sources created at
+runtime. The request names the source in `source_id`; commands for a source
+that does not exist or is not transportable are dropped.
 
 
 | Field | Type | Description |
 |-------|------|-------------|
 | `cmd_type` |  SourceTransportCommandType |  |
 | `value` |  sesame.v1.common.PropValue | Optional; semantics depend on cmd_type |
+| `source_id` |  string | Target source |
 
 
 ### VideoProcessor
@@ -2267,6 +2292,17 @@ Video processor instance configuration.
 | `params` | repeated VideoProcessorParam | Processor parameters |
 
 
+### VideoProcessorControlRequest
+
+Parameter updates for one video processor instance on a source.
+
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `processor_id` |  string | Video processor instance ID (VideoProcessor.id) |
+| `params` | repeated VideoProcessorParam | Parameters to set; omitted parameters are left unchanged |
+
+
 ### VideoProcessorParam
 
 Video processor parameter (mirrors AudioPluginParam).
@@ -2552,6 +2588,17 @@ Transport event (source playback state change).
 | `near_end` |  bool | True in the single event fired when end_notification threshold is crossed |
 
 
+### TransportStatus
+
+Payload for DATA_TYPE_TRANSPORT_STATUS frames on the reserved `sources`
+track: the current transport state of every transportable source.
+
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `sources` | repeated TransportEvent | One entry per transportable source, keyed by source_id |
+
+
 ---
 
 
@@ -2572,7 +2619,7 @@ type, or raw UTF-8 JSON for DATA_TYPE_JSON.
 |-------|------|-------------|
 | 0 | `DATA_TYPE_UNSPECIFIED` |  |
 | 1 | `DATA_TYPE_JSON` |  |
-| 2 | `DATA_TYPE_TRANSPORT_STATUS` | payload: sesame.v1.status.TransportEvent (source → transport) |
+| 2 | `DATA_TYPE_TRANSPORT_STATUS` | payload: sesame.v1.status.TransportStatus (all transportable sources → transport) |
 | 3 | `DATA_TYPE_AUDIO_STATE` | payload: sesame.v1.audio.AudioMixerStatus (mixer → transport) |
 | 4 | `DATA_TYPE_TRANSPORT_CONTROL` | payload: sesame.v1.sources.TransportControlRequest (transport → source) |
 | 5 | `DATA_TYPE_AUDIO_CONTROL` | payload: sesame.v1.audio.AudioControlRequest (transport → mixer) |
@@ -2580,6 +2627,8 @@ type, or raw UTF-8 JSON for DATA_TYPE_JSON.
 | 7 | `DATA_TYPE_OUTPUT_STATUS` | payload: sesame.v1.outputs.OutputStatus (output → transport) |
 | 8 | `DATA_TYPE_OUTPUT_CONTROL` | payload: sesame.v1.outputs.OutputControlRequest (transport → output) |
 | 9 | `DATA_TYPE_ENGINE_STATUS` | payload: sesame.v1.status.Status (engine → transport; full monitor status) |
+| 10 | `DATA_TYPE_SOURCE_CONTROL` | payload: sesame.v1.sources.SourceControlRequest (transport → source) |
+| 11 | `DATA_TYPE_SOURCE_STATUS` | payload: sesame.v1.sources.SourceStatus (source → transport) |
 
 
 ### FrameType
@@ -2796,6 +2845,7 @@ Address format: `processor_id` for preprocessor parameters.
 |----------|------|-------------|
 | `audio_level` | float | Source audio level |
 | `<param_id>` | float | Preprocessor parameter (numeric ID as string) |
+| `reset` | bool | Restore every parameter of the addressed preprocessor to its default |
 
 
 <!-- Hand-maintained sections - appended to generated protocol-reference.md -->