npm - @stinkycomputing/sesame-api-client - Versions diffs - 1.5.1 → 1.5.4 - Mend

@stinkycomputing/sesame-api-client 1.5.1 → 1.5.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (25) hide show

package/LICENSE +22 -22
package/README.md +433 -433
package/dist/browser.cjs +21664 -0
package/dist/browser.cjs.map +7 -0
package/dist/browser.d.ts +16 -0
package/dist/browser.d.ts.map +1 -0
package/dist/browser.mjs +21631 -0
package/dist/browser.mjs.map +7 -0
package/dist/command-list.d.ts +2 -1
package/dist/command-list.d.ts.map +1 -1
package/dist/index.browser.mjs +42 -5
package/dist/index.browser.mjs.map +2 -2
package/dist/index.cjs +42 -5
package/dist/index.cjs.map +2 -2
package/dist/index.mjs +42 -5
package/dist/index.mjs.map +2 -2
package/dist/proto/.gitignore +2 -2
package/dist/proto/api.d.ts +8 -1
package/dist/proto/api.js +35 -0
package/dist/sesame-api-client.d.ts +4 -1
package/dist/sesame-api-client.d.ts.map +1 -1
package/dist/sesame-binary-protocol.d.ts +99 -0
package/dist/sesame-binary-protocol.d.ts.map +1 -0
package/docs/protocol-reference.md +2368 -2207
package/package.json +1 -1

package/docs/protocol-reference.md CHANGED Viewed

@@ -1,2207 +1,2368 @@
-<!-- Generated from .proto files - do not edit manually. -->
-<!-- Regenerate: cmake --build build --target proto-docs -->
-# Sesame Protocol Reference
-Complete reference for all protobuf types available through `@stinkycomputing/sesame-api-client`.
-```typescript
-import { sesame } from '@stinkycomputing/sesame-api-client';
-// All types under sesame.v1.*
-```
----
-## Table of Contents
-- [sesame/v1/audio/audio_mixer.proto](#sesame_v1_audio_audio_mixer-proto)
-- [sesame/v1/commands/commands.proto](#sesame_v1_commands_commands-proto)
-- [sesame/v1/common/common.proto](#sesame_v1_common_common-proto)
-- [sesame/v1/compositor/compositor.proto](#sesame_v1_compositor_compositor-proto)
-- [sesame/v1/jobs/jobs.proto](#sesame_v1_jobs_jobs-proto)
-- [sesame/v1/outputs/output.proto](#sesame_v1_outputs_output-proto)
-- [sesame/v1/recorder/recorder.proto](#sesame_v1_recorder_recorder-proto)
-- [sesame/v1/rpc/rpc.proto](#sesame_v1_rpc_rpc-proto)
-- [sesame/v1/rpc/service.proto](#sesame_v1_rpc_service-proto)
-- [sesame/v1/sources/source.proto](#sesame_v1_sources_source-proto)
-- [sesame/v1/status/statistics.proto](#sesame_v1_status_statistics-proto)
-- [sesame/v1/status/status.proto](#sesame_v1_status_status-proto)
-- [sesame/v1/wire/wire.proto](#sesame_v1_wire_wire-proto)
-- [Event Subscriptions](#event-subscriptions)
-- [Scene Graph Properties](#scene-graph-properties)
----
-## sesame/v1/audio/audio_mixer.proto
-`sesame.v1.audio`
-### AudioMixerChannelType
-Audio mixer channel type.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `AUDIO_MIXER_CHANNEL_TYPE_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `AUDIO_MIXER_CHANNEL_TYPE_MONO` | Mono channel |
-| 2 | `AUDIO_MIXER_CHANNEL_TYPE_STEREO` | Stereo channel |
-### AudioChannelAddRequest
-Request to add a channel to an audio mixer.
-| Field | Type | Description |
-|-------|------|-------------|
-| `mixer_id` |  string |   |
-| `channel_config` |  AudioMixerChannel |   |
-### AudioChannelPluginStatus
-Audio channel plugin status.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `type` |  string |   |
-| `params` | repeated AudioPluginParamStatus |   |
-### AudioChannelRemoveRequest
-Request to remove a channel from an audio mixer.
-| Field | Type | Description |
-|-------|------|-------------|
-| `mixer_id` |  string |   |
-| `channel_id` |  string |   |
-### AudioChannelStatus
-Audio channel status.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `output_type` |  AudioMixerChannelType |   |
-| `level` |  float |   |
-| `pan` |  float |   |
-| `vu` | repeated float |   |
-| `has_data` |  bool |   |
-| `read_errors` |  uint32 |   |
-| `plugins` | repeated AudioChannelPluginStatus |   |
-### AudioMixerAddRequest
-Request to add a new audio mixer.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `config` |  AudioMixerConfig |   |
-### AudioMixerChannel
-Audio mixer channel configuration.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `source_id` |  string |   |
-| `channel_type` |  AudioMixerChannelType |   |
-| `source_channels` | repeated uint32 |   |
-| `level` |  float |   |
-| `pan` |  float |   |
-| `plugins` | repeated AudioPlugin |   |
-### AudioMixerConfig
-Audio mixer configuration.
-| Field | Type | Description |
-|-------|------|-------------|
-| `channels` | repeated AudioMixerChannel |   |
-| `output_type` |  AudioMixerChannelType |   |
-| `order` |  uint32 |   |
-### AudioMixerRemoveRequest
-Request to remove an audio mixer.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-### AudioMixerStatus
-Audio mixer status.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `output_type` |  AudioMixerChannelType |   |
-| `vu` | repeated float |   |
-| `channels` | repeated AudioChannelStatus |   |
-### AudioMixerUpdateRequest
-Request to update an existing audio mixer.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `config` |  AudioMixerConfig |   |
-### AudioPlugin
-Audio plugin instance.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `type` |  string |   |
-| `params` | repeated AudioPluginParam |   |
-| `aux_input_mix_ids` | repeated string |   |
-### AudioPluginParam
-Audio plugin parameter.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  uint32 |   |
-| `float_value` |  float |   |
-### AudioPluginParamStatus
-Audio plugin parameter status (with display info).
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  uint32 |   |
-| `float_value` |  float |   |
-| `label` |  string |   |
-| `display_value` |  string |   |
----
-## sesame/v1/commands/commands.proto
-`sesame.v1.commands`
-### CommandExecutionResponse
-Command execution response.
-Reserved for future per-command results.
-### CommandList
-Command list.
-A list of commands to execute in sequence.
-| Field | Type | Description |
-|-------|------|-------------|
-| `command_list` | repeated CommandListItem |   |
-### CommandListItem
-Command list item.
-Each item represents a single command to execute at a specific time offset.
-| Field | Type | Description |
-|-------|------|-------------|
-| `time_offset_us` |  int64 |   |
-| `add_source` |  sesame.v1.sources.SourceAddRequest |   |
-| `update_source` |  sesame.v1.sources.SourceUpdateRequest |   |
-| `remove_source` |  sesame.v1.sources.SourceRemoveRequest |   |
-| `add_output` |  sesame.v1.outputs.OutputAddRequest |   |
-| `update_output` |  sesame.v1.outputs.OutputUpdateRequest |   |
-| `remove_output` |  sesame.v1.outputs.OutputRemoveRequest |   |
-| `add_compositor` |  sesame.v1.compositor.CompositorAddRequest |   |
-| `remove_compositor` |  sesame.v1.compositor.CompositorRemoveRequest |   |
-| `clear_compositor` |  sesame.v1.compositor.CompositorClearRequest |   |
-| `add_node` |  sesame.v1.compositor.NodeAddRequest |   |
-| `remove_node` |  sesame.v1.compositor.NodeRemoveRequest |   |
-| `set_property` |  sesame.v1.compositor.PropertySetRequest |   |
-| `animate_property` |  sesame.v1.compositor.PropertyAnimateRequest |   |
-| `add_audio_mixer` |  sesame.v1.audio.AudioMixerAddRequest |   |
-| `update_audio_mixer` |  sesame.v1.audio.AudioMixerUpdateRequest |   |
-| `remove_audio_mixer` |  sesame.v1.audio.AudioMixerRemoveRequest |   |
-| `add_audio_channel` |  sesame.v1.audio.AudioChannelAddRequest |   |
-| `remove_audio_channel` |  sesame.v1.audio.AudioChannelRemoveRequest |   |
-| `update_source_transport` |  sesame.v1.sources.SourceTransportCommand |   |
-| `load_playlist` |  sesame.v1.sources.LoadPlaylistRequest |   |
-| `eject_playlist` |  sesame.v1.sources.EjectPlaylistRequest |   |
-| `callback` |  sesame.v1.common.Callback |   |
-| `set_source_metadata` |  sesame.v1.sources.SourceMetadataSetRequest |   |
-| `transaction_id` | optional uint32 |   |
-| `transaction_deps` | repeated uint32 |   |
----
-## sesame/v1/common/common.proto
-`sesame.v1.common`
-### CodecType
-Shared codec identifier for video and audio.
-Video codecs occupy numbers 1–63; audio codecs start at 64.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `CODEC_TYPE_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `CODEC_TYPE_VIDEO_VP8` | VP8 codec |
-| 2 | `CODEC_TYPE_VIDEO_VP9` | VP9 codec |
-| 3 | `CODEC_TYPE_VIDEO_AVC` | H.264/AVC codec |
-| 4 | `CODEC_TYPE_VIDEO_HEVC` | H.265/HEVC codec |
-| 5 | `CODEC_TYPE_VIDEO_AV1` | AV1 codec |
-| 6 | `CODEC_TYPE_VIDEO_PRORES` | Apple ProRes codec family |
-| 7 | `CODEC_TYPE_VIDEO_DNXHR` | Avid DNxHR codec family |
-| 64 | `CODEC_TYPE_AUDIO_OPUS` | Opus audio codec |
-| 65 | `CODEC_TYPE_AUDIO_AAC` | AAC audio codec |
-| 66 | `CODEC_TYPE_AUDIO_PCM` | PCM 16-bit little-endian audio |
-| 67 | `CODEC_TYPE_AUDIO_PCM_S24LE` | PCM 24-bit little-endian audio |
-### ConnectionState
-Connection/lifecycle state for runtime entities (sources, outputs, etc.).
-Used by source/output status models across the API.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `CONNECTION_STATE_UNSPECIFIED` | Unspecified |
-| 1 | `CONNECTION_STATE_INITIALIZING` | Initializing resources |
-| 2 | `CONNECTION_STATE_CONNECTING` | Connecting/opening |
-| 3 | `CONNECTION_STATE_ONLINE` | Healthy and running |
-| 4 | `CONNECTION_STATE_DEGRADED` | Running with reduced health |
-| 5 | `CONNECTION_STATE_OFFLINE` | Stopped or unavailable |
-| 6 | `CONNECTION_STATE_ERROR` | Failed with error |
-### EventTopic
-Typed event topics for subscriptions and event delivery.
-Replaces stringly-typed topic names with compile-time checked values.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `EVENT_TOPIC_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `EVENT_TOPIC_ERROR` | Error events |
-| 2 | `EVENT_TOPIC_TRANSPORT` | Source transport/playback state changes |
-| 3 | `EVENT_TOPIC_CALLBACK` | Client callback events |
-| 4 | `EVENT_TOPIC_JOB` | Job events (export, import, etc.) |
-| 6 | `EVENT_TOPIC_RECORDER` | Recorder events |
-### VideoFormat
-Video format for Decklink and other hardware devices.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `VIDEO_FORMAT_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `VIDEO_FORMAT_1080_50I` | 1080i50 |
-| 2 | `VIDEO_FORMAT_1080_50P` | 1080p50 |
-| 3 | `VIDEO_FORMAT_1080_60I` | 1080i60 |
-| 4 | `VIDEO_FORMAT_1080_60P` | 1080p60 |
-### Callback
-Callback message for event notifications.
-Used to trigger client-side callbacks when specific events occur.
-| Field | Type | Description |
-|-------|------|-------------|
-| `event` |  string |   |
-| `data` |  string |   |
-### Empty
-Empty message for RPCs that don't need request/response data.
-This is the standard protobuf convention for "void" operations.
-### NameValue
-Key-value pair for metadata and generic data.
-Used for transport metadata, custom properties, etc.
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` |  string |   |
-| `value` |  PropValue |   |
-### PropValue
-Property value union type.
-Used for setting compositor properties, audio parameters, etc.
-Only one field should be set at a time.
-| Field | Type | Description |
-|-------|------|-------------|
-| `float_value` |  float |   |
-| `vec4_value` |  Vec4 |   |
-| `string_value` |  string |   |
-| `bool_value` |  bool |   |
-| `int_value` |  int32 |   |
-### PropertyDomain
-Property domain (compositor, audio mixer, etc.).
-Used for property set/animate operations across different domains.
-| Field | Type | Description |
-|-------|------|-------------|
-| `compositor_id` |  string |   |
-| `audio_mixer_id` |  string |   |
-| `replay_id` |  string |   |
-| `source_id` |  string |   |
-### TransportMetadata
-Transport metadata (timecode, etc.).
-Used for source and recorder metadata operations.
-| Field | Type | Description |
-|-------|------|-------------|
-| `items` | repeated NameValue |   |
-### Vec4
-4-component vector used for colors (RGBA), positions, rectangles, etc.
-Components are typically in the range [0.0, 1.0] for colors,
-but can be arbitrary for positions and sizes.
-| Field | Type | Description |
-|-------|------|-------------|
-| `x` |  float |   |
-| `y` |  float |   |
-| `z` |  float |   |
-| `w` |  float |   |
----
-## sesame/v1/compositor/compositor.proto
-`sesame.v1.compositor`
-### AnimationChannelEvaluationMode
-Animation channel evaluation mode.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `ANIM_MODE_CONSTANT` | Constant (hold last value) |
-| 1 | `ANIM_MODE_STATE_FROM` | State from (use initial value) |
-| 2 | `ANIM_MODE_LOOP` | Loop animation |
-| 3 | `ANIM_MODE_BOUNCE` | Bounce animation (ping-pong) |
-### NodeType
-Node type in the scene graph.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `NODE_TYPE_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `NODE_TYPE_GROUP` | Group node (container) |
-| 2 | `NODE_TYPE_TEXT` | Text node |
-| 3 | `NODE_TYPE_VIDEO_BOX` | Video box node |
-| 4 | `NODE_TYPE_IMAGE` | Image node |
-| 5 | `NODE_TYPE_EFFECT_RTT` | Render-to-texture effect |
-| 6 | `NODE_TYPE_EFFECT_TIMECODE` | Timecode display effect |
-| 7 | `NODE_TYPE_EFFECT_CLIP_PLANE` | Clip plane effect |
-### CompositorAddRequest
-Request to add a new compositor.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `multisample` |  bool |   |
-| `width` |  uint32 |   |
-| `height` |  uint32 |   |
-### CompositorClearRequest
-Request to clear a compositor (remove all nodes).
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-### CompositorRemoveRequest
-Request to remove a compositor.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-### KeyFrame
-Animation keyframe.
-| Field | Type | Description |
-|-------|------|-------------|
-| `time_us` |  int64 |   |
-| `value` |  sesame.v1.common.PropValue |   |
-| `easing_in` |  string |   |
-| `easing_out` |  string |   |
-### NodeAddRequest
-Request to add a node to the scene graph.
-| Field | Type | Description |
-|-------|------|-------------|
-| `compositor_id` |  string |   |
-| `parent_address` |  string |   |
-| `node_id` |  string |   |
-| `node_type` |  NodeType |   |
-### NodeRemoveRequest
-Request to remove a node from the scene graph.
-| Field | Type | Description |
-|-------|------|-------------|
-| `compositor_id` |  string |   |
-| `address` |  string |   |
-### PropertyAnimateRequest
-Request to animate a property.
-| Field | Type | Description |
-|-------|------|-------------|
-| `domain` |  sesame.v1.common.PropertyDomain |   |
-| `address` |  string |   |
-| `property` |  string |   |
-| `keyframes` | repeated KeyFrame |   |
-| `before` |  AnimationChannelEvaluationMode |   |
-| `after` |  AnimationChannelEvaluationMode |   |
-### PropertySetRequest
-Request to set a property value.
-| Field | Type | Description |
-|-------|------|-------------|
-| `domain` |  sesame.v1.common.PropertyDomain |   |
-| `address` |  string |   |
-| `property` |  string |   |
-| `value` |  sesame.v1.common.PropValue |   |
----
-## sesame/v1/jobs/jobs.proto
-`sesame.v1.jobs`
-### ContainerFormat
-Container format for exported files.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `CONTAINER_FORMAT_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `CONTAINER_FORMAT_MP4` | MP4 container |
-| 2 | `CONTAINER_FORMAT_MOV` | QuickTime MOV container |
-| 3 | `CONTAINER_FORMAT_MKV` | Matroska container |
-| 4 | `CONTAINER_FORMAT_MXF` | Material eXchange Format |
-### JobStatus
-Job status.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `JOB_STATUS_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `JOB_STATUS_PENDING` | Pending (not started) |
-| 2 | `JOB_STATUS_IN_PROGRESS` | In progress |
-| 3 | `JOB_STATUS_COMPLETE` | Complete |
-| 4 | `JOB_STATUS_ABORTED` | Aborted by user |
-| 5 | `JOB_STATUS_ERROR` | Error occurred |
-### JobType
-Job type.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `JOB_TYPE_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `JOB_TYPE_EXPORT` | Playlist export |
-| 2 | `JOB_TYPE_IMPORT` | Clip import |
-### RateControlMode
-Rate control mode for video encoding.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `RATE_CONTROL_MODE_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `RATE_CONTROL_MODE_CBR` | Constant bitrate |
-| 2 | `RATE_CONTROL_MODE_VBR` | Variable bitrate |
-| 3 | `RATE_CONTROL_MODE_CQ` | Constant quality |
-### ExportConfiguration
-Playlist export configuration.
-| Field | Type | Description |
-|-------|------|-------------|
-| `filename` |  string |   |
-| `container` |  ContainerFormat |   |
-| `video_codec` |  sesame.v1.common.CodecType |   |
-| `width` |  uint32 |   |
-| `height` |  uint32 |   |
-| `fps_num` |  uint32 |   |
-| `fps_den` |  uint32 |   |
-| `rate_control` |  RateControlMode |   |
-| `video_bitrate_kbps` |  uint32 |   |
-| `max_video_bitrate_kbps` |  uint32 |   |
-| `gop_size` |  uint32 |   |
-| `max_b_frames` |  uint32 |   |
-| `profile` |  string |   |
-| `level` |  string |   |
-| `pixel_format` |  string |   |
-| `color_primaries` |  string |   |
-| `color_transfer` |  string |   |
-| `color_matrix` |  string |   |
-| `full_range` |  bool |   |
-| `audio_codec` |  sesame.v1.common.CodecType |   |
-| `audio_bitrate_kbps` |  uint32 |   |
-| `audio_sample_rate_hz` |  uint32 |   |
-| `audio_channels` |  uint32 |   |
-| `audio_routing` | repeated uint32 |   |
-### ExportStartRequest
-Request to start playlist export.
-| Field | Type | Description |
-|-------|------|-------------|
-| `config` |  ExportConfiguration |   |
-| `items` | repeated sesame.v1.recorder.PlaylistItem |   |
-### ImportConfiguration
-Clip import configuration.
-| Field | Type | Description |
-|-------|------|-------------|
-| `src_filename` |  string |   |
-| `audio_routing` | repeated uint32 |   |
-| `dst_recorder_id` |  string |   |
-| `dst_clip_id` |  uint64 |   |
-| `dst_clip_name` |  string |   |
-| `dst_clip_user_data` |  string |   |
-### ImportStartRequest
-Request to start clip import.
-| Field | Type | Description |
-|-------|------|-------------|
-| `config` |  ImportConfiguration |   |
-### Job
-A job. Used as RPC response, list item, and event payload.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  uint32 |   |
-| `type` |  JobType |   |
-| `status` |  JobStatus |   |
-| `name` |  string |   |
-| `description` |  string |   |
-| `error` | optional string |   |
-| `progress` |  int64 |   |
-| `total` |  int64 |   |
-| `timing_info` | optional TimingInfo |   |
-### JobAbortRequest
-Request to abort a job.
-| Field | Type | Description |
-|-------|------|-------------|
-| `job_id` |  uint32 |   |
-### JobList
-List of jobs.
-| Field | Type | Description |
-|-------|------|-------------|
-| `jobs` | repeated Job |   |
-### JobListRequest
-Request to list all jobs.
-### JobStartRequest
-Request to start a job.
-| Field | Type | Description |
-|-------|------|-------------|
-| `export_request` |  ExportStartRequest |   |
-| `import_request` |  ImportStartRequest |   |
-### JobStatusRequest
-Request to get job status.
-| Field | Type | Description |
-|-------|------|-------------|
-| `job_id` |  uint32 |   |
-### TimingInfo
-Timing information for clips.
-| Field | Type | Description |
-|-------|------|-------------|
-| `tc_in` |  int64 |   |
-| `tc_out` |  int64 |   |
----
-## sesame/v1/outputs/output.proto
-`sesame.v1.outputs`
-### EncoderPreset
-Encoder preset.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `ENCODER_PRESET_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `ENCODER_PRESET_LOW_LATENCY` | Low-latency tune |
-| 2 | `ENCODER_PRESET_LOW_LATENCY_IDR_ONLY` | Low-latency with IDR-only GOP |
-| 3 | `ENCODER_PRESET_HIGH_QUALITY` | High-quality tune |
-### OutputType
-Type of output.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `OUTPUT_TYPE_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `OUTPUT_TYPE_ENCODED_WEBSOCKET` | Encoded WebSocket stream |
-| 2 | `OUTPUT_TYPE_ENCODED_RECORDER` | Encoded recorder |
-| 3 | `OUTPUT_TYPE_DECKLINK` | Blackmagic Decklink output |
-| 4 | `OUTPUT_TYPE_SYSTEM_AUDIO` | System audio output |
-| 5 | `OUTPUT_TYPE_ENCODED_SRT` | Encoded SRT stream |
-| 6 | `OUTPUT_TYPE_ENCODED_MOQ` | Encoded MoQ stream |
-| 7 | `OUTPUT_TYPE_ENCODED_SUPER_SLOWMO_RECORDER` | Super slow-mo recorder |
-### RecorderType
-Recorder type.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `RECORDER_TYPE_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `RECORDER_TYPE_LIVE` | Live recorder (circular buffer) |
-| 2 | `RECORDER_TYPE_CLIPS` | Clip recorder; not continuously recording, only ingested frames are persisted |
-### DecklinkOutputConfig
-Decklink output configuration.
-| Field | Type | Description |
-|-------|------|-------------|
-| `device_index` |  uint32 |   |
-| `video_format` |  sesame.v1.common.VideoFormat |   |
-| `key_and_fill` |  bool |   |
-### EncodedMoqOutputConfig
-| Field | Type | Description |
-|-------|------|-------------|
-| `encoder` |  EncoderConfig |   |
-| `url` |  string |   |
-| `broadcast` |  string |   |
-| `key` |  string |   |
-### EncodedRecorderOutputConfig
-| Field | Type | Description |
-|-------|------|-------------|
-| `encoder` |  EncoderConfig |   |
-| `filename` |  string |   |
-| `size_gb` |  uint32 |   |
-| `group_id` |  string |   |
-| `recorder_type` |  RecorderType |   |
-### EncodedSrtOutputConfig
-| Field | Type | Description |
-|-------|------|-------------|
-| `url` |  string |   |
-| `encoder` |  EncoderConfig |   |
-### EncodedSuperSlowMoRecorderOutputConfig
-| Field | Type | Description |
-|-------|------|-------------|
-| `encoder` |  EncoderConfig |   |
-| `filename` |  string |   |
-| `size_gb` |  uint32 |   |
-| `group_id` |  string |   |
-| `recorder_type` |  RecorderType |   |
-| `composition_ids` | repeated string |   |
-| `source_ids` | repeated string |   |
-### EncodedWebSocketOutputConfig
------------------------------------------------------------------------------
-Type-specific output payloads
------------------------------------------------------------------------------
-| Field | Type | Description |
-|-------|------|-------------|
-| `channel` |  string |   |
-| `encoder` |  EncoderConfig |   |
-### EncoderConfig
-Encoded output configuration (WebSocket, SRT, MoQ).
-| Field | Type | Description |
-|-------|------|-------------|
-| `codec` |  sesame.v1.common.CodecType |   |
-| `preset` |  EncoderPreset |   |
-| `bitrate_kbps` |  uint32 |   |
-| `keyframe_interval` |  uint32 |   |
-| `width` |  uint32 |   |
-| `height` |  uint32 |   |
-| `fps` |  float |   |
-### KeyframeRequest
-Keyframe request for encoder.
-Requests an immediate keyframe (IDR frame) from an encoder output.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-### OutputAddRequest
-Request to add a new output.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `composition_id` |  string |   |
-| `audio_mix_ids` | repeated string |   |
-| `use_as_clock` |  bool |   |
-| `websocket` |  EncodedWebSocketOutputConfig |   |
-| `recorder` |  EncodedRecorderOutputConfig |   |
-| `super_slowmo_recorder` |  EncodedSuperSlowMoRecorderOutputConfig |   |
-| `srt` |  EncodedSrtOutputConfig |   |
-| `moq` |  EncodedMoqOutputConfig |   |
-| `decklink` |  DecklinkOutputConfig |   |
-| `system_audio` |  SystemAudioOutputConfig |   |
-### OutputRemoveRequest
-Request to remove an output.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-### OutputStatus
-Output status information.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `type` |  OutputType |   |
-| `state` |  sesame.v1.common.ConnectionState |   |
-| `msg` | optional string |   |
-| `url` |  string |   |
-| `buffer_size` |  uint32 |   |
-| `srt_stats` | optional sesame.v1.status.SRTSendStatistics |   |
-### OutputUpdateRequest
-Request to update an existing output.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `composition_id` |  string |   |
-| `audio_mix_ids` | repeated string |   |
-| `use_as_clock` |  bool |   |
-| `websocket` |  EncodedWebSocketOutputConfig |   |
-| `recorder` |  EncodedRecorderOutputConfig |   |
-| `super_slowmo_recorder` |  EncodedSuperSlowMoRecorderOutputConfig |   |
-| `srt` |  EncodedSrtOutputConfig |   |
-| `moq` |  EncodedMoqOutputConfig |   |
-| `decklink` |  DecklinkOutputConfig |   |
-| `system_audio` |  SystemAudioOutputConfig |   |
-### SystemAudioOutputConfig
-| Field | Type | Description |
-|-------|------|-------------|
-| `device_name` |  string |   |
----
-## sesame/v1/recorder/recorder.proto
-`sesame.v1.recorder`
-### TransitionType
-Transition type for playlist items.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `TRANSITION_TYPE_MIX` | Mix/dissolve transition |
-| 1 | `TRANSITION_TYPE_FADE_TO_COLOR` | Fade to color |
-| 2 | `TRANSITION_TYPE_FADE_FROM_COLOR` | Fade from color |
-| 3 | `TRANSITION_TYPE_FADE_TO_FROM_COLOR` | Fade to and from color |
-### PlaylistItem
-Playlist item for recorder source playback.
-| Field | Type | Description |
-|-------|------|-------------|
-| `recorder_id` |  string |   |
-| `id` |  uint64 |   |
-| `transition_time_us` |  int64 |   |
-| `transition_type` |  TransitionType |   |
-| `transition_fade_color` |  sesame.v1.common.Vec4 |   |
-| `speed` |  float |   |
-| `audio_routing` | repeated uint32 |   |
-| `start_time_us` | optional int64 |   |
-| `end_time_us` | optional int64 |   |
-| `audio_levels` | repeated float |   |
-### RecorderClip
-Recorder clip information.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  uint64 |   |
-| `name` |  string |   |
-| `user_data` |  string |   |
-| `flags` |  uint64 |   |
-| `start_time_us` |  int64 |   |
-| `end_time_us` |  int64 |   |
-| `locked_start_us` |  int64 |   |
-| `locked_end_us` |  int64 |   |
-| `user_time_us` |  int64 |   |
-### RecorderClipAddRequest
-Request to add a clip to a recorder.
-| Field | Type | Description |
-|-------|------|-------------|
-| `clip` |  RecorderClip |   |
-### RecorderClipCopyRequest
-Request to copy a clip.
-| Field | Type | Description |
-|-------|------|-------------|
-| `clip_id` |  uint64 |   |
-| `new_clip_id` |  uint64 |   |
-### RecorderClipFlagSetRequest
-Request to set a clip flag.
-| Field | Type | Description |
-|-------|------|-------------|
-| `clip_id` |  uint64 |   |
-| `flag` |  uint64 |   |
-| `value` |  bool |   |
-### RecorderClipRange
-Clip id range.
-| Field | Type | Description |
-|-------|------|-------------|
-| `low` |  uint64 |   |
-| `high` |  uint64 |   |
-### RecorderClipRemoveRequest
-Request to remove a clip.
-| Field | Type | Description |
-|-------|------|-------------|
-| `clip_id` |  uint64 |   |
-### RecorderClipsClearRequest
-Request to clear clips with filters.
-| Field | Type | Description |
-|-------|------|-------------|
-| `protected_ranges` | repeated RecorderClipRange |   |
-| `must_have_flags` |  uint64 |   |
-| `must_not_have_flags` |  uint64 |   |
-### RecorderClipsGetRequest
-Request to get all clips from a recorder.
-Empty - returns all clips
-### RecorderClipsGetResponse
-Response with recorder clips.
-| Field | Type | Description |
-|-------|------|-------------|
-| `clips` | repeated RecorderClip |   |
-### RecorderClipsVerifyRequest
-Request to verify clip integrity.
-Empty - verifies all clips
-### RecorderClipsVerifyResponse
-Response with verification errors.
-| Field | Type | Description |
-|-------|------|-------------|
-| `errors` | repeated string |   |
-### RecorderEvent
-Recorder event notification.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `online` |  bool |   |
-| `message` | optional string |   |
-### RecorderLockedDurationSetRequest
-Request to set locked duration.
-| Field | Type | Description |
-|-------|------|-------------|
-| `frames` |  uint32 |   |
-### RecorderMetadataSetRequest
-Request to set recorder metadata.
-| Field | Type | Description |
-|-------|------|-------------|
-| `metadata` |  sesame.v1.common.TransportMetadata |   |
-### RecorderOkResponse
-Generic OK response.
-Empty - indicates success
-### RecorderRequest
-Recorder request wrapper.
-| Field | Type | Description |
-|-------|------|-------------|
-| `recorder_id` |  string |   |
-| `get_clips` |  RecorderClipsGetRequest |   |
-| `add_clip` |  RecorderClipAddRequest |   |
-| `remove_clip` |  RecorderClipRemoveRequest |   |
-| `clear_clips` |  RecorderClipsClearRequest |   |
-| `set_metadata` |  RecorderMetadataSetRequest |   |
-| `verify_clips` |  RecorderClipsVerifyRequest |   |
-| `set_clip_flag` |  RecorderClipFlagSetRequest |   |
-| `copy_clip` |  RecorderClipCopyRequest |   |
-| `set_locked_duration` |  RecorderLockedDurationSetRequest |   |
-### RecorderResponse
-Recorder response wrapper.
-| Field | Type | Description |
-|-------|------|-------------|
-| `get_clips_response` |  RecorderClipsGetResponse |   |
-| `ok_response` |  RecorderOkResponse |   |
-| `verify_clips_response` |  RecorderClipsVerifyResponse |   |
-### RecorderStatus
-Recorder status.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
----
-## sesame/v1/rpc/rpc.proto
-`sesame.v1.rpc`
-### Event
-Server event notification.
-| Field | Type | Description |
-|-------|------|-------------|
-| `topic` |  sesame.v1.common.EventTopic |   |
-| `payload` |  bytes |   |
-### Message
-Top-level message wrapper.
-All RPC communication uses this message type.
-Exactly one payload field will be set, determining the message type.
-| Field | Type | Description |
-|-------|------|-------------|
-| `request` |  Request |   |
-| `response` |  Response |   |
-| `event` |  Event |   |
-### Request
-RPC request from client to server.
-| Field | Type | Description |
-|-------|------|-------------|
-| `method` |  string |   |
-| `seq` |  uint32 |   |
-| `payload` |  bytes |   |
-### Response
-RPC response from server to client.
-Error handling:
-- If `ok` is true, `payload` contains the serialized success response and
-  `error` should be empty.
-- If `ok` is false, `error` contains a human-readable message and `payload`
-  may be empty or contain a partial diagnostic payload.
-- Transport-level failures (disconnect/timeouts) are not represented here and
-  must be handled by the framing/transport layer.
-| Field | Type | Description |
-|-------|------|-------------|
-| `seq` |  uint32 |   |
-| `ok` |  bool |   |
-| `payload` |  bytes |   |
-| `error` |  string |   |
----
-## sesame/v1/rpc/service.proto
-`sesame.v1.rpc`
-### SesameAPIService
-Main Sesame API service.
-| Method | Request | Response | Description |
-|--------|---------|----------|-------------|
-| `ExecuteCommandList` | .sesame.v1.commands.CommandList | .sesame.v1.commands.CommandExecutionResponse | Execute a list of commands. |
-| `UpdateSubscriptions` | .sesame.v1.status.SubscriptionRequest | .sesame.v1.common.Empty | Update event subscriptions. |
-| `NotImplemented` | .sesame.v1.common.Empty | .sesame.v1.common.Empty | Not implemented (placeholder). |
-| `RequestEvents` | .sesame.v1.common.Empty | stream .sesame.v1.status.Event | Subscribe to events (server streaming). |
-| `RequestStatus` | .sesame.v1.common.Empty | .sesame.v1.status.Status | Get current system status. |
-| `RequestRecorderOperation` | .sesame.v1.recorder.RecorderRequest | .sesame.v1.recorder.RecorderResponse | Recorder operations. |
-| `StartJob` | .sesame.v1.jobs.JobStartRequest | .sesame.v1.jobs.Job | Job operations. |
-| `AbortJob` | .sesame.v1.jobs.JobAbortRequest | .sesame.v1.jobs.Job | Abort a running job. |
-| `GetJobStatus` | .sesame.v1.jobs.JobStatusRequest | .sesame.v1.jobs.Job | Fetch status for a job. |
-| `ListJobs` | .sesame.v1.jobs.JobListRequest | .sesame.v1.jobs.JobList | List jobs. |
-| `RequestKeyframe` | .sesame.v1.outputs.KeyframeRequest | .sesame.v1.common.Empty | Request keyframe from encoder. |
-| `RequestIODeviceList` | .sesame.v1.common.Empty | .sesame.v1.status.IODeviceListResponse | Get list of I/O devices. |
----
-## sesame/v1/sources/source.proto
-`sesame.v1.sources`
-### DeinterlaceType
-Deinterlacing mode for interlaced sources.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `DEINTERLACE_TYPE_PROGRESSIVE` | Progressive (no deinterlacing) |
-| 1 | `DEINTERLACE_TYPE_UPPER_FIELD_FIRST` | Upper field first |
-| 2 | `DEINTERLACE_TYPE_LOWER_FIELD_FIRST` | Lower field first |
-| 3 | `DEINTERLACE_TYPE_AUTO` | Auto-detect field order |
-### PreprocessStep
-Video preprocessing step type.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `PREPROCESS_STEP_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `PREPROCESS_STEP_VIDEO_SCOPES` | Video scopes/waveform |
-| 2 | `PREPROCESS_STEP_CHROMA_KEY` | Chroma key |
-| 3 | `PREPROCESS_STEP_BLUR` | Blur effect |
-### SourceTextureSize
-Source texture size for GPU upload.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `SOURCE_TEXTURE_SIZE_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `SOURCE_TEXTURE_SIZE_HD` | HD resolution (1920x1080) |
-| 2 | `SOURCE_TEXTURE_SIZE_4K` | 4K resolution (3840x2160) |
-### SourceTransportCommandType
-Source transport command type.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `SOURCE_TRANSPORT_CMD_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `SOURCE_TRANSPORT_CMD_STOP` | Stop playback |
-| 2 | `SOURCE_TRANSPORT_CMD_PLAY` | Start playback |
-| 3 | `SOURCE_TRANSPORT_CMD_SEEK` | Seek to position |
-| 4 | `SOURCE_TRANSPORT_CMD_LOOP` | Set loop mode |
-| 5 | `SOURCE_TRANSPORT_CMD_LIVE` | Switch to live mode |
-| 6 | `SOURCE_TRANSPORT_CMD_JOG` | Jog forward/backward |
-| 7 | `SOURCE_TRANSPORT_CMD_MONITOR` | Monitor mode |
-| 8 | `SOURCE_TRANSPORT_CMD_SEEK_USER_TIME` | Seek to user timecode |
-| 9 | `SOURCE_TRANSPORT_CMD_TAKE` | Take/cut to next |
-| 10 | `SOURCE_TRANSPORT_CMD_POST_ROLL` | Post-roll |
-| 11 | `SOURCE_TRANSPORT_CMD_PRE_ROLL` | Pre-roll |
-| 12 | `SOURCE_TRANSPORT_CMD_NEXT` | Next item |
-| 13 | `SOURCE_TRANSPORT_CMD_SKIP_NEXT` | Skip to next |
-| 14 | `SOURCE_TRANSPORT_CMD_TRANSITIONS_DISABLED` | Disable transitions |
-| 15 | `SOURCE_TRANSPORT_CMD_SET_SCRUBBING` | Set scrubbing mode |
-### SourceTransportState
-Source transport/playback state.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `SOURCE_TRANSPORT_STATE_STOPPED` | Stopped |
-| 1 | `SOURCE_TRANSPORT_STATE_PLAYING` | Playing |
-| 2 | `SOURCE_TRANSPORT_STATE_CUEING` | Cueing to position |
-| 3 | `SOURCE_TRANSPORT_STATE_ERROR` | Error state |
-| 4 | `SOURCE_TRANSPORT_STATE_PLAYING_LIVE` | Playing live (no seeking) |
-### SourceType
-Type of video/audio source.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `SOURCE_TYPE_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `SOURCE_TYPE_FILE` | File source (video/audio file) |
-| 2 | `SOURCE_TYPE_RECORDER` | Recorder playback source |
-| 3 | `SOURCE_TYPE_BROWSER` | Browser/CEF source |
-| 4 | `SOURCE_TYPE_RTT` | Render-to-texture source |
-| 5 | `SOURCE_TYPE_DECKLINK` | Blackmagic Decklink capture |
-| 6 | `SOURCE_TYPE_SIGNAL_GENERATOR` | Test signal generator |
-| 7 | `SOURCE_TYPE_SYSTEM_AUDIO` | System audio input |
-| 8 | `SOURCE_TYPE_SRT_STREAM` | SRT stream |
-| 9 | `SOURCE_TYPE_WEBSOCKET` | WebSocket stream |
-| 10 | `SOURCE_TYPE_MOQ` | Media over QUIC stream |
-### BrowserSourceConfig
-| Field | Type | Description |
-|-------|------|-------------|
-| `url` |  string |   |
-| `width` |  uint32 |   |
-| `height` |  uint32 |   |
-### DecklinkSourceConfig
-Decklink source configuration.
-| Field | Type | Description |
-|-------|------|-------------|
-| `device_index` |  uint32 |   |
-| `video_format` |  sesame.v1.common.VideoFormat |   |
-| `sync_group` | optional uint32 |   |
-### EjectPlaylistRequest
-Request to eject playlist from recorder source.
-| Field | Type | Description |
-|-------|------|-------------|
-| `source_id` |  string |   |
-### FileSourceConfig
-Type-specific source payloads.
-| Field | Type | Description |
-|-------|------|-------------|
-| `url` |  string |   |
-### LoadPlaylistRequest
-Request to load a playlist into a recorder source.
-| Field | Type | Description |
-|-------|------|-------------|
-| `source_id` |  string |   |
-| `user_playlist_id` |  string |   |
-| `items` | repeated sesame.v1.recorder.PlaylistItem |   |
-| `start_time_us` | optional int64 |   |
-| `start_index` | optional int64 |   |
-| `material_pos_us` | optional int64 |   |
-### MoqSourceConfig
-| Field | Type | Description |
-|-------|------|-------------|
-| `url` |  string |   |
-| `broadcast` |  string |   |
-| `key` |  string |   |
-| `decode_buffer_frames` |  uint32 |   |
-### RTTSourceConfig
-RTT (Render-to-Texture) source configuration.
-| Field | Type | Description |
-|-------|------|-------------|
-| `rtt_id` |  string |   |
-| `audio_mixes` | repeated string |   |
-| `delay_frames` |  uint32 |   |
-### RecorderSourceConfig
-| Field | Type | Description |
-|-------|------|-------------|
-| `recorder_id` |  string |   |
-| `codec` |  sesame.v1.common.CodecType |   |
-### SignalGeneratorSourceConfig
-### SourceAddRequest
-Request to add a new source.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `config` |  SourceConfig |   |
-### SourceCommonConfig
-Shared fields for all source kinds.
-| Field | Type | Description |
-|-------|------|-------------|
-| `user_id` |  string |   |
-| `use_as_clock` |  bool |   |
-| `audio_only` |  bool |   |
-| `audio_channels` |  uint32 |   |
-| `loop` |  bool |   |
-| `play_state` |  SourceTransportState |   |
-| `mip_map` |  bool |   |
-| `texture_size` |  SourceTextureSize |   |
-| `deinterlace` |  DeinterlaceType |   |
-| `video_processors` | repeated VideoProcessor |   |
-### SourceConfig
-Source configuration.
-Defines how a source is created and configured.
-| Field | Type | Description |
-|-------|------|-------------|
-| `common` |  SourceCommonConfig |   |
-| `file` |  FileSourceConfig |   |
-| `recorder` |  RecorderSourceConfig |   |
-| `browser` |  BrowserSourceConfig |   |
-| `rtt` |  RTTSourceConfig |   |
-| `decklink` |  DecklinkSourceConfig |   |
-| `signal_generator` |  SignalGeneratorSourceConfig |   |
-| `system_audio` |  SystemAudioSourceConfig |   |
-| `srt_stream` |  SrtSourceConfig |   |
-| `websocket` |  WebsocketSourceConfig |   |
-| `moq` |  MoqSourceConfig |   |
-### SourceMetadataEvent
-Source metadata transport event notification.
-| Field | Type | Description |
-|-------|------|-------------|
-| `source_id` |  string |   |
-| `metadata` |  sesame.v1.common.TransportMetadata |   |
-### SourceMetadataSetRequest
-Request to set source metadata.
-| Field | Type | Description |
-|-------|------|-------------|
-| `source_id` |  string |   |
-| `metadata` |  sesame.v1.common.TransportMetadata |   |
-### SourceRemoveRequest
-Request to remove a source.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-### SourceStatus
-Source status information.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `type` |  SourceType |   |
-| `user_id` |  string |   |
-| `state` |  sesame.v1.common.ConnectionState |   |
-| `transport_state` |  SourceTransportState |   |
-| `msg` | optional string |   |
-| `url` |  string |   |
-| `width` |  uint32 |   |
-| `height` |  uint32 |   |
-| `fps` |  float |   |
-| `duration_us` |  int64 |   |
-| `play_position_us` |  int64 |   |
-| `video_buf` |  int32 |   |
-| `audio_buf` |  int32 |   |
-| `gpu_buf` |  int32 |   |
-| `audio_channels` |  uint32 |   |
-| `audio_level` |  float |   |
-| `lip_sync_offset_us` |  int64 |   |
-| `decode_timing` |  sesame.v1.status.FrameTiming |   |
-| `video_buf_avg` |  double |   |
-| `srt_stats` | optional sesame.v1.status.SRTReceiveStatistics |   |
-### SourceTransportCommand
-Source transport command.
-| Field | Type | Description |
-|-------|------|-------------|
-| `source_id` |  string |   |
-| `cmd_type` |  SourceTransportCommandType |   |
-| `value` |  sesame.v1.common.PropValue |   |
-### SourceUpdateRequest
-Request to update an existing source.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `config` |  SourceConfig |   |
-### SrtSourceConfig
-| Field | Type | Description |
-|-------|------|-------------|
-| `url` |  string |   |
-| `decode_buffer_frames` |  uint32 |   |
-### SystemAudioSourceConfig
-| Field | Type | Description |
-|-------|------|-------------|
-| `device_name` |  string |   |
-### VideoProcessor
-Video processor instance configuration.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `type` |  PreprocessStep |   |
-| `params` | repeated VideoProcessorParam |   |
-### VideoProcessorParam
-Video processor parameter (mirrors AudioPluginParam).
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  uint32 |   |
-| `float_value` |  float |   |
-### WebsocketSourceConfig
-| Field | Type | Description |
-|-------|------|-------------|
-| `channel` |  string |   |
-| `decode_buffer_frames` |  uint32 |   |
----
-## sesame/v1/status/statistics.proto
-`sesame.v1.status`
-### FrameTiming
-Frame timing statistics.
-Used to monitor decode/encode/render performance.
-All times are in microseconds (us).
-| Field | Type | Description |
-|-------|------|-------------|
-| `frame_time` |  int32 |   |
-| `frame_time_avg` |  int32 |   |
-| `frame_time_min` |  int32 |   |
-| `frame_time_max` |  int32 |   |
-### MemoryDomainStats
-Memory domain statistics.
-Tracks memory usage for different allocation domains.
-| Field | Type | Description |
-|-------|------|-------------|
-| `current_bytes` |  uint64 |   |
-| `peak_bytes` |  uint64 |   |
-| `budget_bytes` |  uint64 |   |
-### SRTReceiveStatistics
-SRT receive statistics.
-Provides detailed metrics for SRT stream reception.
-Used for monitoring stream health and diagnosing issues.
-| Field | Type | Description |
-|-------|------|-------------|
-| `packets_received` |  int64 |   |
-| `packets_received_lost` |  int32 |   |
-| `packet_ack_sent` |  int32 |   |
-| `packet_nack_sent` |  int32 |   |
-| `bytes_received` |  int64 |   |
-| `bytes_received_lost` |  int64 |   |
-| `receive_rate_mbps` |  double |   |
-| `tsbpd_delay` |  int32 |   |
-| `bandwidth_mbps` |  double |   |
-| `rtt_ms` |  double |   |
-### SRTSendStatistics
-SRT send statistics.
-Provides detailed metrics for SRT stream transmission.
-| Field | Type | Description |
-|-------|------|-------------|
-| `packets_sent` |  int64 |   |
-| `packets_sent_lost` |  int32 |   |
-| `packets_sent_dropped` |  int32 |   |
-| `packets_retransmitted` |  int32 |   |
-| `packet_ack_received` |  int32 |   |
-| `packet_nack_received` |  int32 |   |
-| `bytes_sent` |  int64 |   |
-| `bytes_sent_dropped` |  int64 |   |
-| `send_rate_mbps` |  double |   |
-| `bandwidth_mbps` |  double |   |
-| `rtt_ms` |  double |   |
-### SystemStatus
-System status information.
-Provides overall system health and performance metrics.
-| Field | Type | Description |
-|-------|------|-------------|
-| `uptime` |  uint64 |   |
-| `framedrops` |  uint32 |   |
-| `framerate` |  float |   |
-| `gpu_mem` |  uint64 |   |
-| `cpu_mem` |  uint64 |   |
-| `mem_gpu_pool` |  MemoryDomainStats |   |
-| `mem_cpu_pool` |  MemoryDomainStats |   |
-| `mem_gpu_adhoc` |  MemoryDomainStats |   |
-| `mem_gpu_pinned` |  MemoryDomainStats |   |
-| `gpu_mem_total` |  uint64 |   |
-| `gpu_mem_used` |  uint64 |   |
-| `gpu_utilization` |  uint32 |   |
-| `gpu_mem_utilization` |  uint32 |   |
-| `gpu_encoder_utilization` |  uint32 |   |
-| `gpu_decoder_utilization` |  uint32 |   |
-| `gpu_name` |  string |   |
-| `vma_bytes` |  uint64 |   |
----
-## sesame/v1/status/status.proto
-`sesame.v1.status`
-### IODeviceType
-I/O device type.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `IO_DEVICE_TYPE_UNSPECIFIED` | Unspecified (invalid) |
-| 1 | `IO_DEVICE_TYPE_VIDEO_INPUT` | Video input device |
-| 2 | `IO_DEVICE_TYPE_VIDEO_OUTPUT` | Video output device |
-| 3 | `IO_DEVICE_TYPE_AUDIO_INPUT` | Audio input device |
-| 4 | `IO_DEVICE_TYPE_AUDIO_OUTPUT` | Audio output device |
-### CompositorStatus
-Compositor status.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-### ErrorEvent
-Error event.
-| Field | Type | Description |
-|-------|------|-------------|
-| `msg` |  string |   |
-### Event
-Event message wrapper.
-| Field | Type | Description |
-|-------|------|-------------|
-| `error_event` |  ErrorEvent |   |
-| `transport_event` |  TransportEvent |   |
-| `callback_event` |  sesame.v1.common.Callback |   |
-| `job_event` |  sesame.v1.jobs.Job |   |
-| `recorder_event` |  sesame.v1.recorder.RecorderEvent |   |
-### IODeviceItem
-I/O device item.
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` |  string |   |
-| `name` |  string |   |
-| `type` |  IODeviceType |   |
-### IODeviceListResponse
-I/O device list response.
-| Field | Type | Description |
-|-------|------|-------------|
-| `devices` | repeated IODeviceItem |   |
-### Status
-Overall system status.
-| Field | Type | Description |
-|-------|------|-------------|
-| `system_status` |  SystemStatus |   |
-| `render_status_gpu` |  FrameTiming |   |
-| `render_status_cpu` |  FrameTiming |   |
-| `sources` | repeated sesame.v1.sources.SourceStatus |   |
-| `compositions` | repeated CompositorStatus |   |
-| `audio_mixes` | repeated sesame.v1.audio.AudioMixerStatus |   |
-| `outputs` | repeated sesame.v1.outputs.OutputStatus |   |
-| `recorders` | repeated sesame.v1.recorder.RecorderStatus |   |
-### SubscriptionRequest
-Subscription request.
-| Field | Type | Description |
-|-------|------|-------------|
-| `event_topics` | repeated sesame.v1.common.EventTopic |   |
-| `channels` | repeated string |   |
-### TransportEvent
-Transport event (source playback state change).
-| Field | Type | Description |
-|-------|------|-------------|
-| `source_id` |  string |   |
-| `user_id` |  string |   |
-| `uri` |  string |   |
-| `state` |  sesame.v1.sources.SourceTransportState |   |
-| `duration_us` |  int64 |   |
-| `position_us` |  int64 |   |
-| `material_position_us` |  int64 |   |
-| `user_time_us` |  int64 |   |
-| `speed` |  float |   |
-| `user_playlist_id` |  string |   |
-| `playlist_index` |  uint32 |   |
-| `playlist_length` |  uint32 |   |
-| `clip_id` |  uint64 |   |
-| `clip_position_us` |  int64 |   |
-| `clip_duration_us` |  int64 |   |
-| `preroll` |  uint32 |   |
-| `postroll` |  uint32 |   |
-| `metadata` |  sesame.v1.common.TransportMetadata |   |
----
-## sesame/v1/wire/wire.proto
-`sesame.v1.wire`
-### FrameType
-Type of frame carried on the wire.
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `FRAME_TYPE_UNSPECIFIED` |  |
-| 1 | `FRAME_TYPE_RPC` |  |
-| 2 | `FRAME_TYPE_VIDEO` |  |
-| 3 | `FRAME_TYPE_AUDIO` |  |
-| 4 | `FRAME_TYPE_MUXED` |  |
-| 5 | `FRAME_TYPE_DECODER_DATA` |  |
-| 6 | `FRAME_TYPE_DATA` |  |
-### FrameHeader
-Header for every websocket / MoQ frame.
-Serialized with a 4-byte little-endian size prefix on the wire.
-| Field | Type | Description |
-|-------|------|-------------|
-| `type` |  FrameType |   |
-| `routing_metadata` |  string |   |
-| `media` |  MediaFrameData |   |
-### MediaCodecData
-Codec parameters for a media stream.
-| Field | Type | Description |
-|-------|------|-------------|
-| `codec_type` |  sesame.v1.common.CodecType |   |
-| `sample_rate` |  uint32 |   |
-| `timebase_num` |  uint32 |   |
-| `timebase_den` |  uint32 |   |
-| `codec_profile` |  uint32 |   |
-| `codec_level` |  uint32 |   |
-| `width` |  uint32 |   |
-| `height` |  uint32 |   |
-| `channels` |  uint32 |   |
-| `bit_depth` |  uint32 |   |
-### MediaFrameData
-Media-specific fields for VIDEO, AUDIO, MUXED, and DECODER_DATA frames.
-| Field | Type | Description |
-|-------|------|-------------|
-| `pts` |  uint64 |   |
-| `keyframe` |  bool |   |
-| `codec_data` |  MediaCodecData |   |
----
-## Scene Graph Properties
-Properties are set via `PropertySetRequest` or animated via `PropertyAnimateRequest`. The `domain` field identifies the owning engine object.
-### Compositor Domain (`domain.compositor_id`)
-#### Base Node Properties (all node types)
-| Property | Type | Description |
-|----------|------|-------------|
-| `position` | vec4 | XYZ position |
-| `position.x` | float | X position |
-| `position.y` | float | Y position |
-| `position.z` | float | Z position / depth |
-| `scale` | vec4 | XYZ scale |
-| `scale.x` | float | X scale |
-| `scale.y` | float | Y scale |
-| `scale.z` | float | Z scale |
-| `rotation` | vec4 | XYZ rotation (degrees) |
-| `rotation.x` | float | X rotation (degrees) |
-| `rotation.y` | float | Y rotation (degrees) |
-| `rotation.z` | float | Z rotation (degrees) |
-| `opacity` | float | Opacity (0-1) |
-| `priority` | float | Render priority (z-order) |
-| `visible` | bool | Visibility |
-| `alpha_map` | string | Alpha map source ID |
-#### Mesh Node (Video Box, Image, Group)
-| Property | Type | Description |
-|----------|------|-------------|
-| `size` | vec4 | Width and height |
-| `size.x` | float | Width |
-| `size.y` | float | Height |
-| `origin` | vec4 | Origin point |
-| `origin.x` | float | Origin X |
-| `origin.y` | float | Origin Y |
-| `color` | vec4 | Color RGBA |
-| `color.r` | float | Red |
-| `color.g` | float | Green |
-| `color.b` | float | Blue |
-| `color.a` | float | Alpha |
-#### Text Node
-| Property | Type | Description |
-|----------|------|-------------|
-| `text` | string | Text content |
-| `justify` | string | Alignment: `left`, `center`, `right` |
-| `font_size` | float | Font size |
-| `outline_color` | vec4 | Outline color |
-| `outline_size` | float | Outline size |
-| `spacing` | float | Letter spacing |
-#### Video Box Node
-| Property | Type | Description |
-|----------|------|-------------|
-| `source` | string | Source ID to display |
-| `audio_meter_source` | string | Pipe-delimited mixer IDs for audio meters |
-| `show_audio_meter` | bool | Show audio meters |
-| `show_border` | bool | Show border |
-| `show_label_bg` | bool | Show label background |
-| `tex_filter` | bool | Texture filtering |
-#### Image Node
-| Property | Type | Description |
-|----------|------|-------------|
-| `filename` | string | Image filename (supports `rtt:` prefix) |
-| `tex_filter` | bool | Texture filtering |
-| `premultiply` | bool | Premultiply alpha |
-#### Effects
-**All effects:**
-| Property | Type | Description |
-|----------|------|-------------|
-| `enabled` | bool | Enable/disable the effect |
-**RTT Effect:**
-| Property | Type | Description |
-|----------|------|-------------|
-| `rtt-id` | string | Render-to-texture target ID |
-**Timecode Effect:**
-| Property | Type | Description |
-|----------|------|-------------|
-| `timecode_type` | string | `internal`, `time_of_day`, `recorder`, `recorder_internal`, `recorder_clip_countdown`, `recorder_playlist_countdown`, `recorder_internal_offset`, `recorder_free_space`, `recorder_playback_speed` |
-| `timecode_src` | string | Source ID for timecode |
-**Clip Plane Effect:**
-| Property | Type | Description |
-|----------|------|-------------|
-| `clip-plane` | vec4 | Clip plane XYZW |
-| `clip-plane.x` | float | Clip plane X |
-| `clip-plane.y` | float | Clip plane Y |
-| `clip-plane.z` | float | Clip plane Z |
-| `clip-plane.w` | float | Clip plane W |
-| `feather` | float | Feather amount |
-### Audio Mixer Domain (`domain.audio_mixer_id`)
-**Address field** identifies the target within the mixer:
-- Channel property — set `address` to the channel ID (e.g. `"video-1"` or `"snigel1-pgm1/audio_mixer_0"`).
-- Plugin parameter — set `address` to `"<channel_id>/<plugin_id>"` and `property` to the numeric param ID as a string (e.g. `"0"`, `"3"`).
-The server disambiguates these two cases by whether `property` parses as an integer: a numeric `property` → plugin parameter path; a named `property` (`"level"`, `"pan"`, etc.) → channel property using the full `address` string as the channel ID. This means channel IDs may safely contain `/` characters.
-| Property | Type | Description |
-|----------|------|-------------|
-| `level` | float | Channel level (0–1) |
-| `pan` | float | Pan position (−1 to 1) |
-| `mute` | bool | Mute channel |
-| `source_channels` | vec4 | Source channel routing (x=ch0, y=ch1, z=ch2, w=ch3) |
-| `source_id` | string | Source ID for the channel |
-| `<param_id>` | float | Plugin parameter — `address` must be `channel_id::plugin_id`, `property` is the numeric param ID |
-**Level animation:** use `propertyAnimate` with `ANIM_MODE_STATE_FROM` to fade from the current level. For an instant cut (no transition), `propertySet` is preferred — a zero-duration `propertyAnimate` is clamped to 1 ms by the server rather than producing an instant cut.
-### Source Domain (`domain.source_id`)
-Address format: `processor_id` for preprocessor parameters.
-| Property | Type | Description |
-|----------|------|-------------|
-| `audio_level` | float | Source audio level |
-| `<param_id>` | float | Preprocessor parameter (numeric ID as string) |
-<!-- Hand-maintained sections - appended to generated protocol-reference.md -->
-<!-- Scene Graph Properties are now auto-generated from property-registry.h -->
-## Event Subscriptions
-Clients must subscribe to receive push events. Call `UpdateSubscriptions` with desired `EventTopic` values:
-```typescript
-client.addSubscription(sesame.v1.common.EventTopic.EVENT_TOPIC_TRANSPORT, callback);
-client.addSubscription(sesame.v1.common.EventTopic.EVENT_TOPIC_JOB, callback);
-```
-| Topic | Event type | When fired |
-|-------|-----------|------------|
-| `EVENT_TOPIC_ERROR` | ErrorEvent | Engine error |
-| `EVENT_TOPIC_TRANSPORT` | TransportEvent | Source playback state change |
-| `EVENT_TOPIC_CALLBACK` | Callback | Client callback command echoed |
-| `EVENT_TOPIC_JOB` | Job | Job lifecycle change + progress (~2 Hz) |
-| `EVENT_TOPIC_RECORDER` | RecorderEvent | Recorder online/offline |
+<!-- Generated from .proto files - do not edit manually. -->
+<!-- Regenerate: cmake --build build --target proto-docs -->
+# Sesame Protocol Reference
+Complete reference for all protobuf types available through `@stinkycomputing/sesame-api-client`.
+```typescript
+import { sesame } from '@stinkycomputing/sesame-api-client';
+// All types under sesame.v1.*
+```
+---
+## Table of Contents
+- [sesame/v1/audio/audio_mixer.proto](#sesame_v1_audio_audio_mixer-proto)
+- [sesame/v1/commands/commands.proto](#sesame_v1_commands_commands-proto)
+- [sesame/v1/common/common.proto](#sesame_v1_common_common-proto)
+- [sesame/v1/compositor/compositor.proto](#sesame_v1_compositor_compositor-proto)
+- [sesame/v1/jobs/jobs.proto](#sesame_v1_jobs_jobs-proto)
+- [sesame/v1/outputs/output.proto](#sesame_v1_outputs_output-proto)
+- [sesame/v1/recorder/recorder.proto](#sesame_v1_recorder_recorder-proto)
+- [sesame/v1/rpc/rpc.proto](#sesame_v1_rpc_rpc-proto)
+- [sesame/v1/rpc/service.proto](#sesame_v1_rpc_service-proto)
+- [sesame/v1/sources/source.proto](#sesame_v1_sources_source-proto)
+- [sesame/v1/status/statistics.proto](#sesame_v1_status_statistics-proto)
+- [sesame/v1/status/status.proto](#sesame_v1_status_status-proto)
+- [sesame/v1/wire/wire.proto](#sesame_v1_wire_wire-proto)
+- [Event Subscriptions](#event-subscriptions)
+- [Scene Graph Properties](#scene-graph-properties)
+---
+## sesame/v1/audio/audio_mixer.proto
+`sesame.v1.audio`
+### AudioMixerChannelType
+Audio mixer channel type.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `AUDIO_MIXER_CHANNEL_TYPE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `AUDIO_MIXER_CHANNEL_TYPE_MONO` | Mono channel |
+| 2 | `AUDIO_MIXER_CHANNEL_TYPE_STEREO` | Stereo channel |
+### AudioChannelAddRequest
+Request to add a channel to an audio mixer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `mixer_id` |  string |   |
+| `channel_config` |  AudioMixerChannel |   |
+### AudioChannelControlRequest
+Per-channel property updates. Absent optional fields are left unchanged.
+| Field | Type | Description |
+|-------|------|-------------|
+| `channel_id` |  string |   |
+| `level` | optional float |   |
+| `pan` | optional float |   |
+| `plugins` | repeated AudioPluginControlRequest |   |
+### AudioChannelPluginStatus
+Audio channel plugin status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `type` |  string |   |
+| `params` | repeated AudioPluginParamStatus |   |
+### AudioChannelRemoveRequest
+Request to remove a channel from an audio mixer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `mixer_id` |  string |   |
+| `channel_id` |  string |   |
+### AudioChannelStatus
+Audio channel status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `output_type` |  AudioMixerChannelType |   |
+| `level` |  float |   |
+| `pan` |  float |   |
+| `vu` | repeated float |   |
+| `has_data` |  bool |   |
+| `read_errors` |  uint32 |   |
+| `plugins` | repeated AudioChannelPluginStatus |   |
+### AudioControlRequest
+Payload for DATA_TYPE_AUDIO_CONTROL frames (transport → server).
+The target mixer ID is NOT included here — it is resolved server-side from
+the MetadataRouter binding configured for this source track. This mirrors
+AudioMixerStatus: to build a control message, take an AudioMixerStatus,
+pick the channels you want to change, copy their `id` into `channel_id`,
+and set the desired `level`/`pan`/plugin params. Omit fields you don't
+want to change (optional fields that are absent are left unchanged).
+| Field | Type | Description |
+|-------|------|-------------|
+| `channels` | repeated AudioChannelControlRequest |   |
+### AudioMixerAddRequest
+Request to add a new audio mixer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `config` |  AudioMixerConfig |   |
+### AudioMixerChannel
+Audio mixer channel configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `source_id` |  string |   |
+| `channel_type` |  AudioMixerChannelType |   |
+| `source_channels` | repeated uint32 |   |
+| `level` |  float |   |
+| `pan` |  float |   |
+| `plugins` | repeated AudioPlugin |   |
+### AudioMixerConfig
+Audio mixer configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `channels` | repeated AudioMixerChannel |   |
+| `output_type` |  AudioMixerChannelType |   |
+| `order` |  uint32 |   |
+### AudioMixerRemoveRequest
+Request to remove an audio mixer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+### AudioMixerStatus
+Audio mixer status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `output_type` |  AudioMixerChannelType |   |
+| `vu` | repeated float |   |
+| `channels` | repeated AudioChannelStatus |   |
+### AudioMixerUpdateRequest
+Request to update an existing audio mixer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `config` |  AudioMixerConfig |   |
+### AudioPlugin
+Audio plugin instance.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `type` |  string |   |
+| `params` | repeated AudioPluginParam |   |
+| `aux_input_mix_ids` | repeated string |   |
+### AudioPluginControlRequest
+Plugin parameter update within an AudioChannelControlRequest.
+| Field | Type | Description |
+|-------|------|-------------|
+| `plugin_id` |  string |   |
+| `params` | repeated AudioPluginParam |   |
+### AudioPluginParam
+Audio plugin parameter.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  uint32 |   |
+| `float_value` |  float |   |
+### AudioPluginParamStatus
+Audio plugin parameter status (with display info).
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  uint32 |   |
+| `float_value` |  float |   |
+| `label` |  string |   |
+| `display_value` |  string |   |
+---
+## sesame/v1/commands/commands.proto
+`sesame.v1.commands`
+### CommandExecutionResponse
+Command execution response.
+Reserved for future per-command results.
+### CommandList
+Command list.
+A list of commands to execute in sequence.
+| Field | Type | Description |
+|-------|------|-------------|
+| `command_list` | repeated CommandListItem |   |
+### CommandListItem
+Command list item.
+Each item represents a single command to execute at a specific time offset.
+| Field | Type | Description |
+|-------|------|-------------|
+| `time_offset_us` |  int64 |   |
+| `add_source` |  sesame.v1.sources.SourceAddRequest |   |
+| `update_source` |  sesame.v1.sources.SourceUpdateRequest |   |
+| `remove_source` |  sesame.v1.sources.SourceRemoveRequest |   |
+| `add_output` |  sesame.v1.outputs.OutputAddRequest |   |
+| `update_output` |  sesame.v1.outputs.OutputUpdateRequest |   |
+| `remove_output` |  sesame.v1.outputs.OutputRemoveRequest |   |
+| `add_compositor` |  sesame.v1.compositor.CompositorAddRequest |   |
+| `remove_compositor` |  sesame.v1.compositor.CompositorRemoveRequest |   |
+| `clear_compositor` |  sesame.v1.compositor.CompositorClearRequest |   |
+| `add_node` |  sesame.v1.compositor.NodeAddRequest |   |
+| `remove_node` |  sesame.v1.compositor.NodeRemoveRequest |   |
+| `set_property` |  sesame.v1.compositor.PropertySetRequest |   |
+| `animate_property` |  sesame.v1.compositor.PropertyAnimateRequest |   |
+| `add_audio_mixer` |  sesame.v1.audio.AudioMixerAddRequest |   |
+| `update_audio_mixer` |  sesame.v1.audio.AudioMixerUpdateRequest |   |
+| `remove_audio_mixer` |  sesame.v1.audio.AudioMixerRemoveRequest |   |
+| `add_audio_channel` |  sesame.v1.audio.AudioChannelAddRequest |   |
+| `remove_audio_channel` |  sesame.v1.audio.AudioChannelRemoveRequest |   |
+| `update_source_transport` |  sesame.v1.sources.SourceTransportCommand |   |
+| `load_playlist` |  sesame.v1.sources.LoadPlaylistRequest |   |
+| `eject_playlist` |  sesame.v1.sources.EjectPlaylistRequest |   |
+| `callback` |  sesame.v1.common.Callback |   |
+| `set_source_metadata` |  sesame.v1.sources.SourceMetadataSetRequest |   |
+| `set_metadata_bindings` |  SetMetadataBindingsRequest |   |
+| `transaction_id` | optional uint32 |   |
+| `transaction_deps` | repeated uint32 |   |
+### MetadataBinding
+Routes metadata between producers and consumers across transport boundaries.
+Outbound route:
+  source_id + metadata_id -> output_id + track_name
+Inbound route:
+  source_id + track_name -> target_id + metadata_id
+Exactly one route direction should be specified per binding:
+  - outbound: output_id is set, target_id is empty
+  - inbound:  target_id is set, output_id is empty
+| Field | Type | Description |
+|-------|------|-------------|
+| `source_id` |  string |   |
+| `metadata_id` |  string |   |
+| `output_id` |  string |   |
+| `track_name` |  string |   |
+| `target_id` |  string |   |
+### SetMetadataBindingsRequest
+Replaces the full metadata routing table.
+Send once after all sources/outputs are configured.
+| Field | Type | Description |
+|-------|------|-------------|
+| `bindings` | repeated MetadataBinding |   |
+---
+## sesame/v1/common/common.proto
+`sesame.v1.common`
+### CodecType
+Shared codec identifier for video and audio.
+Video codecs occupy numbers 1–63; audio codecs start at 64.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `CODEC_TYPE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `CODEC_TYPE_VIDEO_VP8` | VP8 codec |
+| 2 | `CODEC_TYPE_VIDEO_VP9` | VP9 codec |
+| 3 | `CODEC_TYPE_VIDEO_AVC` | H.264/AVC codec |
+| 4 | `CODEC_TYPE_VIDEO_HEVC` | H.265/HEVC codec |
+| 5 | `CODEC_TYPE_VIDEO_AV1` | AV1 codec |
+| 6 | `CODEC_TYPE_VIDEO_PRORES` | Apple ProRes codec family |
+| 7 | `CODEC_TYPE_VIDEO_DNXHR` | Avid DNxHR codec family |
+| 64 | `CODEC_TYPE_AUDIO_OPUS` | Opus audio codec |
+| 65 | `CODEC_TYPE_AUDIO_AAC` | AAC audio codec |
+| 66 | `CODEC_TYPE_AUDIO_PCM` | PCM 16-bit little-endian audio |
+| 67 | `CODEC_TYPE_AUDIO_PCM_S24LE` | PCM 24-bit little-endian audio |
+### ConnectionState
+Connection/lifecycle state for runtime entities (sources, outputs, etc.).
+Used by source/output status models across the API.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `CONNECTION_STATE_UNSPECIFIED` | Unspecified |
+| 1 | `CONNECTION_STATE_INITIALIZING` | Initializing resources |
+| 2 | `CONNECTION_STATE_CONNECTING` | Connecting/opening |
+| 3 | `CONNECTION_STATE_ONLINE` | Healthy and running |
+| 4 | `CONNECTION_STATE_DEGRADED` | Running with reduced health |
+| 5 | `CONNECTION_STATE_OFFLINE` | Stopped or unavailable |
+| 6 | `CONNECTION_STATE_ERROR` | Failed with error |
+### EventTopic
+Typed event topics for subscriptions and event delivery.
+Replaces stringly-typed topic names with compile-time checked values.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `EVENT_TOPIC_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `EVENT_TOPIC_ERROR` | Error events |
+| 2 | `EVENT_TOPIC_TRANSPORT` | Source transport/playback state changes |
+| 3 | `EVENT_TOPIC_CALLBACK` | Client callback events |
+| 4 | `EVENT_TOPIC_JOB` | Job events (export, import, etc.) |
+| 5 | `EVENT_TOPIC_METADATA` | JSON metadata track events (inbound data frames routed to apps) |
+| 6 | `EVENT_TOPIC_RECORDER` | Recorder events |
+### VideoFormat
+Video format for Decklink and other hardware devices.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `VIDEO_FORMAT_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `VIDEO_FORMAT_1080_50I` | 1080i50 |
+| 2 | `VIDEO_FORMAT_1080_50P` | 1080p50 |
+| 3 | `VIDEO_FORMAT_1080_60I` | 1080i60 |
+| 4 | `VIDEO_FORMAT_1080_60P` | 1080p60 |
+### Callback
+Callback message for event notifications.
+Used to trigger client-side callbacks when specific events occur.
+| Field | Type | Description |
+|-------|------|-------------|
+| `event` |  string |   |
+| `data` |  string |   |
+### Empty
+Empty message for RPCs that don't need request/response data.
+This is the standard protobuf convention for "void" operations.
+### NameValue
+Key-value pair for metadata and generic data.
+Used for transport metadata, custom properties, etc.
+| Field | Type | Description |
+|-------|------|-------------|
+| `name` |  string |   |
+| `value` |  PropValue |   |
+### PropValue
+Property value union type.
+Used for setting compositor properties, audio parameters, etc.
+Only one field should be set at a time.
+| Field | Type | Description |
+|-------|------|-------------|
+| `float_value` |  float |   |
+| `vec4_value` |  Vec4 |   |
+| `string_value` |  string |   |
+| `bool_value` |  bool |   |
+| `int_value` |  int64 |   |
+### PropertyDomain
+Property domain (compositor, audio mixer, etc.).
+Used for property set/animate operations across different domains.
+| Field | Type | Description |
+|-------|------|-------------|
+| `compositor_id` |  string |   |
+| `audio_mixer_id` |  string |   |
+| `replay_id` |  string |   |
+| `source_id` |  string |   |
+### TransportMetadata
+Transport metadata (timecode, etc.).
+Used for source and recorder metadata operations.
+| Field | Type | Description |
+|-------|------|-------------|
+| `items` | repeated NameValue |   |
+### Vec4
+4-component vector used for colors (RGBA), positions, rectangles, etc.
+Components are typically in the range [0.0, 1.0] for colors,
+but can be arbitrary for positions and sizes.
+| Field | Type | Description |
+|-------|------|-------------|
+| `x` |  float |   |
+| `y` |  float |   |
+| `z` |  float |   |
+| `w` |  float |   |
+---
+## sesame/v1/compositor/compositor.proto
+`sesame.v1.compositor`
+### AnimationChannelEvaluationMode
+Animation channel evaluation mode.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `ANIM_MODE_CONSTANT` | Constant (hold last value) |
+| 1 | `ANIM_MODE_STATE_FROM` | State from (use initial value) |
+| 2 | `ANIM_MODE_LOOP` | Loop animation |
+| 3 | `ANIM_MODE_BOUNCE` | Bounce animation (ping-pong) |
+### NodeType
+Node type in the scene graph.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `NODE_TYPE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `NODE_TYPE_GROUP` | Group node (container) |
+| 2 | `NODE_TYPE_TEXT` | Text node |
+| 3 | `NODE_TYPE_VIDEO_BOX` | Video box node |
+| 4 | `NODE_TYPE_IMAGE` | Image node |
+| 5 | `NODE_TYPE_EFFECT_RTT` | Render-to-texture effect |
+| 6 | `NODE_TYPE_EFFECT_TIMECODE` | Timecode display effect |
+| 7 | `NODE_TYPE_EFFECT_CLIP_PLANE` | Clip plane effect |
+### CompositorAddRequest
+Request to add a new compositor.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `multisample` |  bool |   |
+| `width` |  uint32 |   |
+| `height` |  uint32 |   |
+### CompositorClearRequest
+Request to clear a compositor (remove all nodes).
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+### CompositorRemoveRequest
+Request to remove a compositor.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+### KeyFrame
+Animation keyframe.
+| Field | Type | Description |
+|-------|------|-------------|
+| `time_us` |  int64 |   |
+| `value` |  sesame.v1.common.PropValue |   |
+| `easing_in` |  string |   |
+| `easing_out` |  string |   |
+### NodeAddRequest
+Request to add a node to the scene graph.
+| Field | Type | Description |
+|-------|------|-------------|
+| `compositor_id` |  string |   |
+| `parent_address` |  string |   |
+| `node_id` |  string |   |
+| `node_type` |  NodeType |   |
+### NodeRemoveRequest
+Request to remove a node from the scene graph.
+| Field | Type | Description |
+|-------|------|-------------|
+| `compositor_id` |  string |   |
+| `address` |  string |   |
+### PropertyAnimateRequest
+Request to animate a property.
+| Field | Type | Description |
+|-------|------|-------------|
+| `domain` |  sesame.v1.common.PropertyDomain |   |
+| `address` |  string |   |
+| `property` |  string |   |
+| `keyframes` | repeated KeyFrame |   |
+| `before` |  AnimationChannelEvaluationMode |   |
+| `after` |  AnimationChannelEvaluationMode |   |
+### PropertySetRequest
+Request to set a property value.
+| Field | Type | Description |
+|-------|------|-------------|
+| `domain` |  sesame.v1.common.PropertyDomain |   |
+| `address` |  string |   |
+| `property` |  string |   |
+| `value` |  sesame.v1.common.PropValue |   |
+---
+## sesame/v1/jobs/jobs.proto
+`sesame.v1.jobs`
+### ContainerFormat
+Container format for exported files.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `CONTAINER_FORMAT_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `CONTAINER_FORMAT_MP4` | MP4 container |
+| 2 | `CONTAINER_FORMAT_MOV` | QuickTime MOV container |
+| 3 | `CONTAINER_FORMAT_MKV` | Matroska container |
+| 4 | `CONTAINER_FORMAT_MXF` | Material eXchange Format |
+### JobStatus
+Job status.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `JOB_STATUS_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `JOB_STATUS_PENDING` | Pending (not started) |
+| 2 | `JOB_STATUS_IN_PROGRESS` | In progress |
+| 3 | `JOB_STATUS_COMPLETE` | Complete |
+| 4 | `JOB_STATUS_ABORTED` | Aborted by user |
+| 5 | `JOB_STATUS_ERROR` | Error occurred |
+### JobType
+Job type.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `JOB_TYPE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `JOB_TYPE_EXPORT` | Playlist export |
+| 2 | `JOB_TYPE_IMPORT` | Clip import |
+### RateControlMode
+Rate control mode for video encoding.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `RATE_CONTROL_MODE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `RATE_CONTROL_MODE_CBR` | Constant bitrate |
+| 2 | `RATE_CONTROL_MODE_VBR` | Variable bitrate |
+| 3 | `RATE_CONTROL_MODE_CQ` | Constant quality |
+### ExportConfiguration
+Playlist export configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `filename` |  string |   |
+| `container` |  ContainerFormat |   |
+| `video_codec` |  sesame.v1.common.CodecType |   |
+| `width` |  uint32 |   |
+| `height` |  uint32 |   |
+| `fps_num` |  uint32 |   |
+| `fps_den` |  uint32 |   |
+| `rate_control` |  RateControlMode |   |
+| `video_bitrate_kbps` |  uint32 |   |
+| `max_video_bitrate_kbps` |  uint32 |   |
+| `gop_size` |  uint32 |   |
+| `max_b_frames` |  uint32 |   |
+| `profile` |  string |   |
+| `level` |  string |   |
+| `pixel_format` |  string |   |
+| `color_primaries` |  string |   |
+| `color_transfer` |  string |   |
+| `color_matrix` |  string |   |
+| `full_range` |  bool |   |
+| `audio_codec` |  sesame.v1.common.CodecType |   |
+| `audio_bitrate_kbps` |  uint32 |   |
+| `audio_sample_rate_hz` |  uint32 |   |
+| `audio_channels` |  uint32 |   |
+| `audio_routing` | repeated uint32 |   |
+### ExportStartRequest
+Request to start playlist export.
+| Field | Type | Description |
+|-------|------|-------------|
+| `config` |  ExportConfiguration |   |
+| `items` | repeated sesame.v1.recorder.PlaylistItem |   |
+### ImportConfiguration
+Clip import configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `src_filename` |  string |   |
+| `audio_routing` | repeated uint32 |   |
+| `dst_recorder_id` |  string |   |
+| `dst_clip_id` |  uint64 |   |
+| `dst_clip_name` |  string |   |
+| `dst_clip_user_data` |  string |   |
+### ImportStartRequest
+Request to start clip import.
+| Field | Type | Description |
+|-------|------|-------------|
+| `config` |  ImportConfiguration |   |
+### Job
+A job. Used as RPC response, list item, and event payload.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  uint32 |   |
+| `type` |  JobType |   |
+| `status` |  JobStatus |   |
+| `name` |  string |   |
+| `description` |  string |   |
+| `error` | optional string |   |
+| `progress` |  int64 |   |
+| `total` |  int64 |   |
+| `timing_info` | optional TimingInfo |   |
+### JobAbortRequest
+Request to abort a job.
+| Field | Type | Description |
+|-------|------|-------------|
+| `job_id` |  uint32 |   |
+### JobList
+List of jobs.
+| Field | Type | Description |
+|-------|------|-------------|
+| `jobs` | repeated Job |   |
+### JobListRequest
+Request to list all jobs.
+### JobStartRequest
+Request to start a job.
+| Field | Type | Description |
+|-------|------|-------------|
+| `export_request` |  ExportStartRequest |   |
+| `import_request` |  ImportStartRequest |   |
+### JobStatusRequest
+Request to get job status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `job_id` |  uint32 |   |
+### TimingInfo
+Timing information for clips.
+| Field | Type | Description |
+|-------|------|-------------|
+| `tc_in` |  int64 |   |
+| `tc_out` |  int64 |   |
+---
+## sesame/v1/outputs/output.proto
+`sesame.v1.outputs`
+### EncoderPreset
+Encoder preset.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `ENCODER_PRESET_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `ENCODER_PRESET_LOW_LATENCY` | Low-latency tune |
+| 2 | `ENCODER_PRESET_LOW_LATENCY_IDR_ONLY` | Low-latency with IDR-only GOP |
+| 3 | `ENCODER_PRESET_HIGH_QUALITY` | High-quality tune |
+### OutputType
+Type of output.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `OUTPUT_TYPE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `OUTPUT_TYPE_ENCODED_WEBSOCKET` | Encoded WebSocket stream |
+| 2 | `OUTPUT_TYPE_ENCODED_RECORDER` | Encoded recorder |
+| 3 | `OUTPUT_TYPE_DECKLINK` | Blackmagic Decklink output |
+| 4 | `OUTPUT_TYPE_SYSTEM_AUDIO` | System audio output |
+| 5 | `OUTPUT_TYPE_ENCODED_SRT` | Encoded SRT stream |
+| 6 | `OUTPUT_TYPE_ENCODED_MOQ` | Encoded MoQ stream |
+| 7 | `OUTPUT_TYPE_ENCODED_SUPER_SLOWMO_RECORDER` | Super slow-mo recorder |
+### RecorderType
+Recorder type.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `RECORDER_TYPE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `RECORDER_TYPE_LIVE` | Live recorder (circular buffer) |
+| 2 | `RECORDER_TYPE_CLIPS` | Clip recorder; not continuously recording, only ingested frames are persisted |
+### DecklinkOutputConfig
+Decklink output configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `device_index` |  uint32 |   |
+| `video_format` |  sesame.v1.common.VideoFormat |   |
+| `key_and_fill` |  bool |   |
+### EncodedMoqOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `encoder` |  EncoderConfig |   |
+| `url` |  string |   |
+| `broadcast` |  string |   |
+| `key` |  string |   |
+| `metadata_tracks` | repeated string |   |
+### EncodedRecorderOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `encoder` |  EncoderConfig |   |
+| `filename` |  string |   |
+| `size_gb` |  uint32 |   |
+| `group_id` |  string |   |
+| `recorder_type` |  RecorderType |   |
+### EncodedSrtOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `url` |  string |   |
+| `encoder` |  EncoderConfig |   |
+### EncodedSuperSlowMoRecorderOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `encoder` |  EncoderConfig |   |
+| `filename` |  string |   |
+| `size_gb` |  uint32 |   |
+| `group_id` |  string |   |
+| `recorder_type` |  RecorderType |   |
+| `composition_ids` | repeated string |   |
+| `source_ids` | repeated string |   |
+### EncodedWebSocketOutputConfig
+-----------------------------------------------------------------------------
+Type-specific output payloads
+-----------------------------------------------------------------------------
+| Field | Type | Description |
+|-------|------|-------------|
+| `channel` |  string |   |
+| `encoder` |  EncoderConfig |   |
+| `metadata_tracks` | repeated string |   |
+### EncoderConfig
+Encoded output configuration (WebSocket, SRT, MoQ).
+| Field | Type | Description |
+|-------|------|-------------|
+| `codec` |  sesame.v1.common.CodecType |   |
+| `preset` |  EncoderPreset |   |
+| `bitrate_kbps` |  uint32 |   |
+| `keyframe_interval` |  uint32 |   |
+| `width` |  uint32 |   |
+| `height` |  uint32 |   |
+| `fps` |  float |   |
+### KeyframeRequest
+Keyframe request for encoder.
+Requests an immediate keyframe (IDR frame) from an encoder output.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+### OutputAddRequest
+Request to add a new output.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `composition_id` |  string |   |
+| `audio_mix_ids` | repeated string |   |
+| `use_as_clock` |  bool |   |
+| `websocket` |  EncodedWebSocketOutputConfig |   |
+| `recorder` |  EncodedRecorderOutputConfig |   |
+| `super_slowmo_recorder` |  EncodedSuperSlowMoRecorderOutputConfig |   |
+| `srt` |  EncodedSrtOutputConfig |   |
+| `moq` |  EncodedMoqOutputConfig |   |
+| `decklink` |  DecklinkOutputConfig |   |
+| `system_audio` |  SystemAudioOutputConfig |   |
+### OutputRemoveRequest
+Request to remove an output.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+### OutputStatus
+Output status information.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `type` |  OutputType |   |
+| `state` |  sesame.v1.common.ConnectionState |   |
+| `msg` | optional string |   |
+| `url` |  string |   |
+| `buffer_size` |  uint32 |   |
+| `srt_stats` | optional sesame.v1.status.SRTSendStatistics |   |
+### OutputUpdateRequest
+Request to update an existing output.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `composition_id` |  string |   |
+| `audio_mix_ids` | repeated string |   |
+| `use_as_clock` |  bool |   |
+| `websocket` |  EncodedWebSocketOutputConfig |   |
+| `recorder` |  EncodedRecorderOutputConfig |   |
+| `super_slowmo_recorder` |  EncodedSuperSlowMoRecorderOutputConfig |   |
+| `srt` |  EncodedSrtOutputConfig |   |
+| `moq` |  EncodedMoqOutputConfig |   |
+| `decklink` |  DecklinkOutputConfig |   |
+| `system_audio` |  SystemAudioOutputConfig |   |
+### SystemAudioOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `device_name` |  string |   |
+---
+## sesame/v1/recorder/recorder.proto
+`sesame.v1.recorder`
+### TransitionType
+Transition type for playlist items.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `TRANSITION_TYPE_MIX` | Mix/dissolve transition |
+| 1 | `TRANSITION_TYPE_FADE_TO_COLOR` | Fade to color |
+| 2 | `TRANSITION_TYPE_FADE_FROM_COLOR` | Fade from color |
+| 3 | `TRANSITION_TYPE_FADE_TO_FROM_COLOR` | Fade to and from color |
+### PlaylistItem
+Playlist item for recorder source playback.
+| Field | Type | Description |
+|-------|------|-------------|
+| `recorder_id` |  string |   |
+| `id` |  uint64 |   |
+| `transition_time_us` |  int64 |   |
+| `transition_type` |  TransitionType |   |
+| `transition_fade_color` |  sesame.v1.common.Vec4 |   |
+| `speed` |  float |   |
+| `audio_routing` | repeated uint32 |   |
+| `start_time_us` | optional int64 |   |
+| `end_time_us` | optional int64 |   |
+| `audio_levels` | repeated float |   |
+### RecorderClip
+Recorder clip information.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  uint64 |   |
+| `name` |  string |   |
+| `user_data` |  string |   |
+| `flags` |  uint64 |   |
+| `start_time_us` |  int64 |   |
+| `end_time_us` |  int64 |   |
+| `locked_start_us` |  int64 |   |
+| `locked_end_us` |  int64 |   |
+| `user_time_us` |  int64 |   |
+### RecorderClipAddRequest
+Request to add a clip to a recorder.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clip` |  RecorderClip |   |
+### RecorderClipCopyRequest
+Request to copy a clip.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clip_id` |  uint64 |   |
+| `new_clip_id` |  uint64 |   |
+### RecorderClipFlagSetRequest
+Request to set a clip flag.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clip_id` |  uint64 |   |
+| `flag` |  uint64 |   |
+| `value` |  bool |   |
+### RecorderClipRange
+Clip id range.
+| Field | Type | Description |
+|-------|------|-------------|
+| `low` |  uint64 |   |
+| `high` |  uint64 |   |
+### RecorderClipRemoveRequest
+Request to remove a clip.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clip_id` |  uint64 |   |
+### RecorderClipsClearRequest
+Request to clear clips with filters.
+| Field | Type | Description |
+|-------|------|-------------|
+| `protected_ranges` | repeated RecorderClipRange |   |
+| `must_have_flags` |  uint64 |   |
+| `must_not_have_flags` |  uint64 |   |
+### RecorderClipsGetRequest
+Request to get all clips from a recorder.
+Empty - returns all clips
+### RecorderClipsGetResponse
+Response with recorder clips.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clips` | repeated RecorderClip |   |
+### RecorderClipsVerifyRequest
+Request to verify clip integrity.
+Empty - verifies all clips
+### RecorderClipsVerifyResponse
+Response with verification errors.
+| Field | Type | Description |
+|-------|------|-------------|
+| `errors` | repeated string |   |
+### RecorderEvent
+Recorder event notification.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `online` |  bool |   |
+| `message` | optional string |   |
+### RecorderLockedDurationSetRequest
+Request to set locked duration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `frames` |  uint32 |   |
+### RecorderMetadataSetRequest
+Request to set recorder metadata.
+| Field | Type | Description |
+|-------|------|-------------|
+| `metadata` |  sesame.v1.common.TransportMetadata |   |
+### RecorderOkResponse
+Generic OK response.
+Empty - indicates success
+### RecorderRequest
+Recorder request wrapper.
+| Field | Type | Description |
+|-------|------|-------------|
+| `recorder_id` |  string |   |
+| `get_clips` |  RecorderClipsGetRequest |   |
+| `add_clip` |  RecorderClipAddRequest |   |
+| `remove_clip` |  RecorderClipRemoveRequest |   |
+| `clear_clips` |  RecorderClipsClearRequest |   |
+| `set_metadata` |  RecorderMetadataSetRequest |   |
+| `verify_clips` |  RecorderClipsVerifyRequest |   |
+| `set_clip_flag` |  RecorderClipFlagSetRequest |   |
+| `copy_clip` |  RecorderClipCopyRequest |   |
+| `set_locked_duration` |  RecorderLockedDurationSetRequest |   |
+### RecorderResponse
+Recorder response wrapper.
+| Field | Type | Description |
+|-------|------|-------------|
+| `get_clips_response` |  RecorderClipsGetResponse |   |
+| `ok_response` |  RecorderOkResponse |   |
+| `verify_clips_response` |  RecorderClipsVerifyResponse |   |
+### RecorderStatus
+Recorder status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+---
+## sesame/v1/rpc/rpc.proto
+`sesame.v1.rpc`
+### Event
+Server event notification.
+| Field | Type | Description |
+|-------|------|-------------|
+| `topic` |  sesame.v1.common.EventTopic |   |
+| `payload` |  bytes |   |
+### Message
+Top-level message wrapper.
+All RPC communication uses this message type.
+Exactly one payload field will be set, determining the message type.
+| Field | Type | Description |
+|-------|------|-------------|
+| `request` |  Request |   |
+| `response` |  Response |   |
+| `event` |  Event |   |
+### Request
+RPC request from client to server.
+| Field | Type | Description |
+|-------|------|-------------|
+| `method` |  string |   |
+| `seq` |  uint32 |   |
+| `payload` |  bytes |   |
+### Response
+RPC response from server to client.
+Error handling:
+- If `ok` is true, `payload` contains the serialized success response and
+  `error` should be empty.
+- If `ok` is false, `error` contains a human-readable message and `payload`
+  may be empty or contain a partial diagnostic payload.
+- Transport-level failures (disconnect/timeouts) are not represented here and
+  must be handled by the framing/transport layer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `seq` |  uint32 |   |
+| `ok` |  bool |   |
+| `payload` |  bytes |   |
+| `error` |  string |   |
+---
+## sesame/v1/rpc/service.proto
+`sesame.v1.rpc`
+### PublishMetadataRequest
+Request to publish a metadata payload from an app to all output transports
+that have a binding from this node+metadataId.
+| Field | Type | Description |
+|-------|------|-------------|
+| `node_id` |  string |   |
+| `metadata_id` |  string |   |
+| `payload` |  bytes |   |
+| `data_type` |  sesame.v1.wire.DataType |   |
+### SesameAPIService
+Main Sesame API service.
+| Method | Request | Response | Description |
+|--------|---------|----------|-------------|
+| `ExecuteCommandList` | .sesame.v1.commands.CommandList | .sesame.v1.commands.CommandExecutionResponse | Execute a list of commands. |
+| `UpdateSubscriptions` | .sesame.v1.status.SubscriptionRequest | .sesame.v1.common.Empty | Update event subscriptions. |
+| `NotImplemented` | .sesame.v1.common.Empty | .sesame.v1.common.Empty | Not implemented (placeholder). |
+| `RequestEvents` | .sesame.v1.common.Empty | stream .sesame.v1.status.Event | Subscribe to events (server streaming). |
+| `RequestStatus` | .sesame.v1.common.Empty | .sesame.v1.status.Status | Get current system status. |
+| `RequestRecorderOperation` | .sesame.v1.recorder.RecorderRequest | .sesame.v1.recorder.RecorderResponse | Recorder operations. |
+| `StartJob` | .sesame.v1.jobs.JobStartRequest | .sesame.v1.jobs.Job | Job operations. |
+| `AbortJob` | .sesame.v1.jobs.JobAbortRequest | .sesame.v1.jobs.Job | Abort a running job. |
+| `GetJobStatus` | .sesame.v1.jobs.JobStatusRequest | .sesame.v1.jobs.Job | Fetch status for a job. |
+| `ListJobs` | .sesame.v1.jobs.JobListRequest | .sesame.v1.jobs.JobList | List jobs. |
+| `RequestKeyframe` | .sesame.v1.outputs.KeyframeRequest | .sesame.v1.common.Empty | Request keyframe from encoder. |
+| `RequestIODeviceList` | .sesame.v1.common.Empty | .sesame.v1.status.IODeviceListResponse | Get list of I/O devices. |
+| `PublishMetadata` | PublishMetadataRequest | .sesame.v1.common.Empty | Publish a JSON metadata payload to all output transports bound to this node+metadataId. Used by apps (e.g. Snigel) to emit state that should be forwarded on MoQ/WebSocket outputs. |
+---
+## sesame/v1/sources/source.proto
+`sesame.v1.sources`
+### DeinterlaceType
+Deinterlacing mode for interlaced sources.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `DEINTERLACE_TYPE_PROGRESSIVE` | Progressive (no deinterlacing) |
+| 1 | `DEINTERLACE_TYPE_UPPER_FIELD_FIRST` | Upper field first |
+| 2 | `DEINTERLACE_TYPE_LOWER_FIELD_FIRST` | Lower field first |
+| 3 | `DEINTERLACE_TYPE_AUTO` | Auto-detect field order |
+### PreprocessStep
+Video preprocessing step type.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `PREPROCESS_STEP_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `PREPROCESS_STEP_VIDEO_SCOPES` | Video scopes/waveform |
+| 2 | `PREPROCESS_STEP_CHROMA_KEY` | Chroma key |
+| 3 | `PREPROCESS_STEP_BLUR` | Blur effect |
+### SourceTextureSize
+Source texture size for GPU upload.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `SOURCE_TEXTURE_SIZE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `SOURCE_TEXTURE_SIZE_HD` | HD resolution (1920x1080) |
+| 2 | `SOURCE_TEXTURE_SIZE_4K` | 4K resolution (3840x2160) |
+### SourceTransportCommandType
+Source transport command type.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `SOURCE_TRANSPORT_CMD_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `SOURCE_TRANSPORT_CMD_STOP` | Stop playback |
+| 2 | `SOURCE_TRANSPORT_CMD_PLAY` | Start playback |
+| 3 | `SOURCE_TRANSPORT_CMD_SEEK` | Seek to position |
+| 4 | `SOURCE_TRANSPORT_CMD_LOOP` | Set loop mode |
+| 5 | `SOURCE_TRANSPORT_CMD_LIVE` | Switch to live mode |
+| 6 | `SOURCE_TRANSPORT_CMD_JOG` | Jog forward/backward |
+| 7 | `SOURCE_TRANSPORT_CMD_MONITOR` | Monitor mode |
+| 8 | `SOURCE_TRANSPORT_CMD_SEEK_USER_TIME` | Seek to user timecode |
+| 9 | `SOURCE_TRANSPORT_CMD_TAKE` | Take/cut to next |
+| 10 | `SOURCE_TRANSPORT_CMD_POST_ROLL` | Post-roll |
+| 11 | `SOURCE_TRANSPORT_CMD_PRE_ROLL` | Pre-roll |
+| 12 | `SOURCE_TRANSPORT_CMD_NEXT` | Next item |
+| 13 | `SOURCE_TRANSPORT_CMD_SKIP_NEXT` | Skip to next |
+| 14 | `SOURCE_TRANSPORT_CMD_TRANSITIONS_DISABLED` | Disable transitions |
+| 15 | `SOURCE_TRANSPORT_CMD_SET_SCRUBBING` | Set scrubbing mode |
+| 16 | `SOURCE_TRANSPORT_CMD_SET_END_NOTIFICATION` | Set near-end callback threshold (int64 µs before end; 0 = disabled) |
+### SourceTransportState
+Source transport/playback state.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `SOURCE_TRANSPORT_STATE_STOPPED` | Stopped |
+| 1 | `SOURCE_TRANSPORT_STATE_PLAYING` | Playing |
+| 2 | `SOURCE_TRANSPORT_STATE_CUEING` | Cueing to position |
+| 3 | `SOURCE_TRANSPORT_STATE_ERROR` | Error state |
+| 4 | `SOURCE_TRANSPORT_STATE_PLAYING_LIVE` | Playing live (no seeking) |
+### SourceType
+Type of video/audio source.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `SOURCE_TYPE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `SOURCE_TYPE_FILE` | File source (video/audio file) |
+| 2 | `SOURCE_TYPE_RECORDER` | Recorder playback source |
+| 3 | `SOURCE_TYPE_BROWSER` | Browser/CEF source |
+| 4 | `SOURCE_TYPE_RTT` | Render-to-texture source |
+| 5 | `SOURCE_TYPE_DECKLINK` | Blackmagic Decklink capture |
+| 6 | `SOURCE_TYPE_SIGNAL_GENERATOR` | Test signal generator |
+| 7 | `SOURCE_TYPE_SYSTEM_AUDIO` | System audio input |
+| 8 | `SOURCE_TYPE_SRT_STREAM` | SRT stream |
+| 9 | `SOURCE_TYPE_WEBSOCKET` | WebSocket stream |
+| 10 | `SOURCE_TYPE_MOQ` | Media over QUIC stream |
+### BrowserSourceConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `url` |  string |   |
+| `width` |  uint32 |   |
+| `height` |  uint32 |   |
+### DecklinkSourceConfig
+Decklink source configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `device_index` |  uint32 |   |
+| `video_format` |  sesame.v1.common.VideoFormat |   |
+| `sync_group` | optional uint32 |   |
+### EjectPlaylistRequest
+Request to eject playlist from recorder source.
+| Field | Type | Description |
+|-------|------|-------------|
+| `source_id` |  string |   |
+### FileSourceConfig
+Type-specific source payloads.
+| Field | Type | Description |
+|-------|------|-------------|
+| `url` |  string |   |
+### LoadPlaylistRequest
+Request to load a playlist into a recorder source.
+| Field | Type | Description |
+|-------|------|-------------|
+| `source_id` |  string |   |
+| `user_playlist_id` |  string |   |
+| `items` | repeated sesame.v1.recorder.PlaylistItem |   |
+| `start_time_us` | optional int64 |   |
+| `start_index` | optional int64 |   |
+| `material_pos_us` | optional int64 |   |
+### MoqSourceConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `url` |  string |   |
+| `broadcast` |  string |   |
+| `key` |  string |   |
+| `decode_buffer_frames` |  uint32 |   |
+| `incoming_metadata_tracks` | repeated string |   |
+### RTTSourceConfig
+RTT (Render-to-Texture) source configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `rtt_id` |  string |   |
+| `audio_mixes` | repeated string |   |
+| `delay_frames` |  uint32 |   |
+### RecorderSourceConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `recorder_id` |  string |   |
+| `codec` |  sesame.v1.common.CodecType |   |
+### SignalGeneratorSourceConfig
+### SourceAddRequest
+Request to add a new source.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `config` |  SourceConfig |   |
+### SourceCommonConfig
+Shared fields for all source kinds.
+| Field | Type | Description |
+|-------|------|-------------|
+| `user_id` |  string |   |
+| `use_as_clock` |  bool |   |
+| `audio_only` |  bool |   |
+| `audio_channels` |  uint32 |   |
+| `loop` |  bool |   |
+| `play_state` |  SourceTransportState |   |
+| `mip_map` |  bool |   |
+| `texture_size` |  SourceTextureSize |   |
+| `deinterlace` |  DeinterlaceType |   |
+| `video_processors` | repeated VideoProcessor |   |
+### SourceConfig
+Source configuration.
+Defines how a source is created and configured.
+| Field | Type | Description |
+|-------|------|-------------|
+| `common` |  SourceCommonConfig |   |
+| `file` |  FileSourceConfig |   |
+| `recorder` |  RecorderSourceConfig |   |
+| `browser` |  BrowserSourceConfig |   |
+| `rtt` |  RTTSourceConfig |   |
+| `decklink` |  DecklinkSourceConfig |   |
+| `signal_generator` |  SignalGeneratorSourceConfig |   |
+| `system_audio` |  SystemAudioSourceConfig |   |
+| `srt_stream` |  SrtSourceConfig |   |
+| `websocket` |  WebsocketSourceConfig |   |
+| `moq` |  MoqSourceConfig |   |
+### SourceMetadataEvent
+Source metadata transport event notification.
+| Field | Type | Description |
+|-------|------|-------------|
+| `source_id` |  string |   |
+| `metadata` |  sesame.v1.common.TransportMetadata |   |
+### SourceMetadataSetRequest
+Request to set source metadata.
+| Field | Type | Description |
+|-------|------|-------------|
+| `source_id` |  string |   |
+| `metadata` |  sesame.v1.common.TransportMetadata |   |
+### SourceRemoveRequest
+Request to remove a source.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+### SourceStatus
+Source status information.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `type` |  SourceType |   |
+| `user_id` |  string |   |
+| `state` |  sesame.v1.common.ConnectionState |   |
+| `transport_state` |  SourceTransportState |   |
+| `msg` | optional string |   |
+| `url` |  string |   |
+| `width` |  uint32 |   |
+| `height` |  uint32 |   |
+| `fps` |  float |   |
+| `duration_us` |  int64 |   |
+| `play_position_us` |  int64 |   |
+| `video_buf` |  int32 |   |
+| `audio_buf` |  int32 |   |
+| `gpu_buf` |  int32 |   |
+| `audio_channels` |  uint32 |   |
+| `audio_level` |  float |   |
+| `lip_sync_offset_us` |  int64 |   |
+| `decode_timing` |  sesame.v1.status.FrameTiming |   |
+| `video_buf_avg` |  double |   |
+| `srt_stats` | optional sesame.v1.status.SRTReceiveStatistics |   |
+### SourceTransportCommand
+Source transport command.
+| Field | Type | Description |
+|-------|------|-------------|
+| `source_id` |  string |   |
+| `cmd_type` |  SourceTransportCommandType |   |
+| `value` |  sesame.v1.common.PropValue |   |
+### SourceUpdateRequest
+Request to update an existing source.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `config` |  SourceConfig |   |
+### SrtSourceConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `url` |  string |   |
+| `decode_buffer_frames` |  uint32 |   |
+### SystemAudioSourceConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `device_name` |  string |   |
+### TransportControlRequest
+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.
+| Field | Type | Description |
+|-------|------|-------------|
+| `cmd_type` |  SourceTransportCommandType |   |
+| `value` |  sesame.v1.common.PropValue |   |
+### VideoProcessor
+Video processor instance configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `type` |  PreprocessStep |   |
+| `params` | repeated VideoProcessorParam |   |
+### VideoProcessorParam
+Video processor parameter (mirrors AudioPluginParam).
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  uint32 |   |
+| `float_value` |  float |   |
+### WebsocketSourceConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `channel` |  string |   |
+| `decode_buffer_frames` |  uint32 |   |
+| `incoming_metadata_tracks` | repeated string |   |
+---
+## sesame/v1/status/statistics.proto
+`sesame.v1.status`
+### FrameTiming
+Frame timing statistics.
+Used to monitor decode/encode/render performance.
+All times are in microseconds (us).
+| Field | Type | Description |
+|-------|------|-------------|
+| `frame_time` |  int32 |   |
+| `frame_time_avg` |  int32 |   |
+| `frame_time_min` |  int32 |   |
+| `frame_time_max` |  int32 |   |
+### MemoryDomainStats
+Memory domain statistics.
+Tracks memory usage for different allocation domains.
+| Field | Type | Description |
+|-------|------|-------------|
+| `current_bytes` |  uint64 |   |
+| `peak_bytes` |  uint64 |   |
+| `budget_bytes` |  uint64 |   |
+### SRTReceiveStatistics
+SRT receive statistics.
+Provides detailed metrics for SRT stream reception.
+Used for monitoring stream health and diagnosing issues.
+| Field | Type | Description |
+|-------|------|-------------|
+| `packets_received` |  int64 |   |
+| `packets_received_lost` |  int32 |   |
+| `packet_ack_sent` |  int32 |   |
+| `packet_nack_sent` |  int32 |   |
+| `bytes_received` |  int64 |   |
+| `bytes_received_lost` |  int64 |   |
+| `receive_rate_mbps` |  double |   |
+| `tsbpd_delay` |  int32 |   |
+| `bandwidth_mbps` |  double |   |
+| `rtt_ms` |  double |   |
+### SRTSendStatistics
+SRT send statistics.
+Provides detailed metrics for SRT stream transmission.
+| Field | Type | Description |
+|-------|------|-------------|
+| `packets_sent` |  int64 |   |
+| `packets_sent_lost` |  int32 |   |
+| `packets_sent_dropped` |  int32 |   |
+| `packets_retransmitted` |  int32 |   |
+| `packet_ack_received` |  int32 |   |
+| `packet_nack_received` |  int32 |   |
+| `bytes_sent` |  int64 |   |
+| `bytes_sent_dropped` |  int64 |   |
+| `send_rate_mbps` |  double |   |
+| `bandwidth_mbps` |  double |   |
+| `rtt_ms` |  double |   |
+### SystemStatus
+System status information.
+Provides overall system health and performance metrics.
+| Field | Type | Description |
+|-------|------|-------------|
+| `uptime` |  uint64 |   |
+| `framedrops` |  uint32 |   |
+| `framerate` |  float |   |
+| `gpu_mem` |  uint64 |   |
+| `cpu_mem` |  uint64 |   |
+| `mem_gpu_pool` |  MemoryDomainStats |   |
+| `mem_cpu_pool` |  MemoryDomainStats |   |
+| `mem_gpu_adhoc` |  MemoryDomainStats |   |
+| `mem_gpu_pinned` |  MemoryDomainStats |   |
+| `gpu_mem_total` |  uint64 |   |
+| `gpu_mem_used` |  uint64 |   |
+| `gpu_utilization` |  uint32 |   |
+| `gpu_mem_utilization` |  uint32 |   |
+| `gpu_encoder_utilization` |  uint32 |   |
+| `gpu_decoder_utilization` |  uint32 |   |
+| `gpu_name` |  string |   |
+| `vma_bytes` |  uint64 |   |
+---
+## sesame/v1/status/status.proto
+`sesame.v1.status`
+### IODeviceType
+I/O device type.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `IO_DEVICE_TYPE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `IO_DEVICE_TYPE_VIDEO_INPUT` | Video input device |
+| 2 | `IO_DEVICE_TYPE_VIDEO_OUTPUT` | Video output device |
+| 3 | `IO_DEVICE_TYPE_AUDIO_INPUT` | Audio input device |
+| 4 | `IO_DEVICE_TYPE_AUDIO_OUTPUT` | Audio output device |
+### CompositorStatus
+Compositor status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+### ErrorEvent
+Error event.
+| Field | Type | Description |
+|-------|------|-------------|
+| `msg` |  string |   |
+### Event
+Event message wrapper.
+| Field | Type | Description |
+|-------|------|-------------|
+| `error_event` |  ErrorEvent |   |
+| `transport_event` |  TransportEvent |   |
+| `callback_event` |  sesame.v1.common.Callback |   |
+| `job_event` |  sesame.v1.jobs.Job |   |
+| `metadata_event` |  MetadataEvent |   |
+| `recorder_event` |  sesame.v1.recorder.RecorderEvent |   |
+### IODeviceItem
+I/O device item.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `name` |  string |   |
+| `type` |  IODeviceType |   |
+### IODeviceListResponse
+I/O device list response.
+| Field | Type | Description |
+|-------|------|-------------|
+| `devices` | repeated IODeviceItem |   |
+### MetadataEvent
+Fired when a metadata DATA frame arrives on a streaming source and is
+routed to an app consumer via the metadata binding table.
+| Field | Type | Description |
+|-------|------|-------------|
+| `source_node_id` |  string |   |
+| `track_name` |  string |   |
+| `target_node_id` |  string |   |
+| `metadata_id` |  string |   |
+| `payload` |  bytes |   |
+### Status
+Overall system status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `system_status` |  SystemStatus |   |
+| `render_status_gpu` |  FrameTiming |   |
+| `render_status_cpu` |  FrameTiming |   |
+| `sources` | repeated sesame.v1.sources.SourceStatus |   |
+| `compositions` | repeated CompositorStatus |   |
+| `audio_mixes` | repeated sesame.v1.audio.AudioMixerStatus |   |
+| `outputs` | repeated sesame.v1.outputs.OutputStatus |   |
+| `recorders` | repeated sesame.v1.recorder.RecorderStatus |   |
+### SubscriptionRequest
+Subscription request.
+| Field | Type | Description |
+|-------|------|-------------|
+| `event_topics` | repeated sesame.v1.common.EventTopic |   |
+| `channels` | repeated string |   |
+### TransportEvent
+Transport event (source playback state change).
+| Field | Type | Description |
+|-------|------|-------------|
+| `source_id` |  string |   |
+| `user_id` |  string |   |
+| `uri` |  string |   |
+| `state` |  sesame.v1.sources.SourceTransportState |   |
+| `duration_us` |  int64 |   |
+| `position_us` |  int64 |   |
+| `material_position_us` |  int64 |   |
+| `user_time_us` |  int64 |   |
+| `speed` |  float |   |
+| `user_playlist_id` |  string |   |
+| `playlist_index` |  uint32 |   |
+| `playlist_length` |  uint32 |   |
+| `clip_id` |  uint64 |   |
+| `clip_position_us` |  int64 |   |
+| `clip_duration_us` |  int64 |   |
+| `preroll` |  uint32 |   |
+| `postroll` |  uint32 |   |
+| `metadata` |  sesame.v1.common.TransportMetadata |   |
+| `near_end` |  bool | True in the single event fired when the end-notification threshold is crossed |
+---
+## sesame/v1/wire/wire.proto
+`sesame.v1.wire`
+### DataType
+Payload type carried in a FRAME_TYPE_DATA frame.
+The frame payload bytes are a serialized protobuf message of the indicated
+type, or raw UTF-8 JSON for DATA_TYPE_JSON.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `DATA_TYPE_UNSPECIFIED` |  |
+| 1 | `DATA_TYPE_JSON` |  |
+| 2 | `DATA_TYPE_TRANSPORT_STATUS` | payload: sesame.v1.status.TransportEvent (source → 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) |
+| 6 | `DATA_TYPE_BINARY` | payload: raw binary bytes (opaque to the wire layer) |
+### FrameType
+Type of frame carried on the wire.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `FRAME_TYPE_UNSPECIFIED` |  |
+| 1 | `FRAME_TYPE_RPC` |  |
+| 2 | `FRAME_TYPE_VIDEO` |  |
+| 3 | `FRAME_TYPE_AUDIO` |  |
+| 4 | `FRAME_TYPE_MUXED` |  |
+| 5 | `FRAME_TYPE_DECODER_DATA` |  |
+| 6 | `FRAME_TYPE_DATA` |  |
+### DataFrameData
+Header data for FRAME_TYPE_DATA frames.
+| Field | Type | Description |
+|-------|------|-------------|
+| `data_type` |  DataType |   |
+| `track_name` |  string |   |
+### FrameHeader
+Header for every websocket / MoQ frame.
+Serialized with a 4-byte little-endian size prefix on the wire.
+| Field | Type | Description |
+|-------|------|-------------|
+| `type` |  FrameType |   |
+| `routing_metadata` |  string |   |
+| `media` |  MediaFrameData |   |
+| `data` |  DataFrameData |   |
+### MediaCodecData
+Codec parameters for a media stream.
+| Field | Type | Description |
+|-------|------|-------------|
+| `codec_type` |  sesame.v1.common.CodecType |   |
+| `sample_rate` |  uint32 |   |
+| `timebase_num` |  uint32 |   |
+| `timebase_den` |  uint32 |   |
+| `codec_profile` |  uint32 |   |
+| `codec_level` |  uint32 |   |
+| `width` |  uint32 |   |
+| `height` |  uint32 |   |
+| `channels` |  uint32 |   |
+| `bit_depth` |  uint32 |   |
+### MediaFrameData
+Media-specific fields for VIDEO, AUDIO, MUXED, and DECODER_DATA frames.
+| Field | Type | Description |
+|-------|------|-------------|
+| `pts` |  uint64 |   |
+| `keyframe` |  bool |   |
+| `codec_data` |  MediaCodecData |   |
+---
+## Scene Graph Properties
+Properties are set via `PropertySetRequest` or animated via `PropertyAnimateRequest`. The `domain` field identifies the owning engine object.
+### Compositor Domain (`domain.compositor_id`)
+#### Base Node Properties (all node types)
+| Property | Type | Description |
+|----------|------|-------------|
+| `position` | vec4 | XYZ position |
+| `position.x` | float | X position |
+| `position.y` | float | Y position |
+| `position.z` | float | Z position / depth |
+| `scale` | vec4 | XYZ scale |
+| `scale.x` | float | X scale |
+| `scale.y` | float | Y scale |
+| `scale.z` | float | Z scale |
+| `rotation` | vec4 | XYZ rotation (degrees) |
+| `rotation.x` | float | X rotation (degrees) |
+| `rotation.y` | float | Y rotation (degrees) |
+| `rotation.z` | float | Z rotation (degrees) |
+| `opacity` | float | Opacity (0-1) |
+| `priority` | float | Render priority (z-order) |
+| `visible` | bool | Visibility |
+| `alpha_map` | string | Alpha map source ID |
+#### Mesh Node (Video Box, Image, Group)
+| Property | Type | Description |
+|----------|------|-------------|
+| `size` | vec4 | Width and height |
+| `size.x` | float | Width |
+| `size.y` | float | Height |
+| `origin` | vec4 | Origin point |
+| `origin.x` | float | Origin X |
+| `origin.y` | float | Origin Y |
+| `color` | vec4 | Color RGBA |
+| `color.r` | float | Red |
+| `color.g` | float | Green |
+| `color.b` | float | Blue |
+| `color.a` | float | Alpha |
+#### Text Node
+| Property | Type | Description |
+|----------|------|-------------|
+| `text` | string | Text content |
+| `justify` | string | Alignment: `left`, `center`, `right` |
+| `font_size` | float | Font size |
+| `outline_color` | vec4 | Outline color |
+| `outline_size` | float | Outline size |
+| `spacing` | float | Letter spacing |
+#### Video Box Node
+| Property | Type | Description |
+|----------|------|-------------|
+| `source` | string | Source ID to display |
+| `audio_meter_source` | string | Pipe-delimited mixer IDs for audio meters |
+| `show_audio_meter` | bool | Show audio meters |
+| `show_border` | bool | Show border |
+| `show_label_bg` | bool | Show label background |
+| `tex_filter` | bool | Texture filtering |
+#### Image Node
+| Property | Type | Description |
+|----------|------|-------------|
+| `filename` | string | Image filename (supports `rtt:` prefix) |
+| `tex_filter` | bool | Texture filtering |
+| `premultiply` | bool | Premultiply alpha |
+#### Effects
+**All effects:**
+| Property | Type | Description |
+|----------|------|-------------|
+| `enabled` | bool | Enable/disable the effect |
+**RTT Effect:**
+| Property | Type | Description |
+|----------|------|-------------|
+| `rtt-id` | string | Render-to-texture target ID |
+**Timecode Effect:**
+| Property | Type | Description |
+|----------|------|-------------|
+| `timecode_type` | string | `internal`, `time_of_day`, `recorder`, `recorder_internal`, `recorder_clip_countdown`, `recorder_playlist_countdown`, `recorder_internal_offset`, `recorder_free_space`, `recorder_playback_speed` |
+| `timecode_src` | string | Source ID for timecode |
+**Clip Plane Effect:**
+| Property | Type | Description |
+|----------|------|-------------|
+| `clip-plane` | vec4 | Clip plane XYZW |
+| `clip-plane.x` | float | Clip plane X |
+| `clip-plane.y` | float | Clip plane Y |
+| `clip-plane.z` | float | Clip plane Z |
+| `clip-plane.w` | float | Clip plane W |
+| `feather` | float | Feather amount |
+### Audio Mixer Domain (`domain.audio_mixer_id`)
+**Address field** identifies the target within the mixer:
+- Channel property — set `address` to the channel ID (e.g. `"video-1"` or `"snigel1-pgm1/audio_mixer_0"`).
+- Plugin parameter — set `address` to `"<channel_id>::<plugin_id>"` and `property` to the numeric param ID as a string (e.g. `"0"`, `"3"`).
+The server disambiguates these two cases by whether `address` contains the `::` delimiter: if it does, the address is split into channel ID and plugin ID, and `property` is parsed as a numeric param ID; otherwise the full `address` string is used as the channel ID for a named channel property.
+| Property | Type | Description |
+|----------|------|-------------|
+| `level` | float | Channel level (0-1) |
+| `pan` | float | Pan position (-1 to 1) |
+| `mute` | bool | Mute channel |
+| `source_channels` | vec4 | Source channel routing |
+| `source_id` | string | Source ID |
+| `<param_id>` | float | Plugin parameter — `address` must be `channel_id::plugin_id`, `property` is the numeric param ID |
+**Level animation:** use `propertyAnimate` with `ANIM_MODE_STATE_FROM` to fade from the current level. For an instant cut (no transition), `propertySet` is preferred — a zero-duration `propertyAnimate` is clamped to 1 ms by the server rather than producing an instant cut.
+### Source Domain (`domain.source_id`)
+Address format: `processor_id` for preprocessor parameters.
+| Property | Type | Description |
+|----------|------|-------------|
+| `audio_level` | float | Source audio level |
+| `<param_id>` | float | Preprocessor parameter (numeric ID as string) |
+<!-- Hand-maintained sections - appended to generated protocol-reference.md -->
+<!-- Scene Graph Properties are now auto-generated from property-registry.h -->
+## Event Subscriptions
+Clients must subscribe to receive push events. Call `UpdateSubscriptions` with desired `EventTopic` values:
+```typescript
+client.addSubscription(sesame.v1.common.EventTopic.EVENT_TOPIC_TRANSPORT, callback);
+client.addSubscription(sesame.v1.common.EventTopic.EVENT_TOPIC_JOB, callback);
+```
+| Topic | Event type | When fired |
+|-------|-----------|------------|
+| `EVENT_TOPIC_ERROR` | ErrorEvent | Engine error |
+| `EVENT_TOPIC_TRANSPORT` | TransportEvent | Source playback state change; also fired once per playback run with `near_end=true` when the end-notification threshold is crossed |
+| `EVENT_TOPIC_CALLBACK` | Callback | Client callback command echoed |
+| `EVENT_TOPIC_JOB` | Job | Job lifecycle change + progress (~2 Hz) |
+| `EVENT_TOPIC_RECORDER` | RecorderEvent | Recorder online/offline |