npm - @stinkycomputing/sesame-api-client - Versions diffs - 1.4.1-beta.10 → 1.4.1-beta.12 - Mend

@stinkycomputing/sesame-api-client 1.4.1-beta.10 → 1.4.1-beta.12

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 (11) hide show

package/dist/command-list.d.ts +25 -1
package/dist/command-list.d.ts.map +1 -1
package/dist/generated/property-types.d.ts +869 -0
package/dist/generated/property-types.d.ts.map +1 -0
package/dist/index.browser.mjs.map +2 -2
package/dist/index.cjs.map +2 -2
package/dist/index.d.ts +1 -0
package/dist/index.d.ts.map +1 -1
package/dist/index.mjs.map +2 -2
package/docs/protocol-reference.md +1749 -765
package/package.json +5 -3

package/docs/protocol-reference.md CHANGED Viewed

@@ -1,3 +1,6 @@
+<!-- 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`.
@@ -11,97 +14,307 @@ import { sesame } from '@stinkycomputing/sesame-api-client';
 ## Table of Contents
-- [Wire Protocol](#wire-protocol) — `sesame.v1.wire`
-- [Common Types](#common-types) — `sesame.v1.common`
-- [RPC Envelope](#rpc-envelope) — `sesame.v1.rpc`
-- [Commands](#commands) — `sesame.v1.commands`
-- [Sources](#sources) — `sesame.v1.sources`
-- [Outputs](#outputs) — `sesame.v1.outputs`
-- [Compositor & Scene Graph](#compositor--scene-graph) — `sesame.v1.compositor`
-- [Audio Mixer](#audio-mixer) — `sesame.v1.audio`
-- [Recorder](#recorder) — `sesame.v1.recorder`
-- [Jobs](#jobs) — `sesame.v1.jobs`
-- [Status & Events](#status--events) — `sesame.v1.status`
-- [Statistics](#statistics) — `sesame.v1.status` (statistics)
-- [Service Methods](#service-methods)
+- [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)
 ---
-## Wire Protocol
-`sesame.v1.wire`
+## sesame/v1/audio/audio_mixer.proto
-Every WebSocket message is framed as:
+`sesame.v1.audio`
-```
-[4-byte LE header_size][FrameHeader protobuf][payload bytes]
-```
-### FrameType
+### AudioMixerChannelType
+Audio mixer channel type.
 | Value | Name | Description |
 |-------|------|-------------|
-| 0 | `FRAME_TYPE_UNSPECIFIED` | Invalid |
-| 1 | `FRAME_TYPE_RPC` | Request/response RPC and events |
-| 2 | `FRAME_TYPE_VIDEO` | Live video frames |
-| 3 | `FRAME_TYPE_AUDIO` | Live audio frames |
-| 4 | `FRAME_TYPE_MUXED` | Muxed audio+video data |
-| 5 | `FRAME_TYPE_DECODER_DATA` | Codec init data (SPS/PPS) |
-| 6 | `FRAME_TYPE_DATA` | Live metadata streams |
+| 0 | `AUDIO_MIXER_CHANNEL_TYPE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `AUDIO_MIXER_CHANNEL_TYPE_MONO` | Mono channel |
+| 2 | `AUDIO_MIXER_CHANNEL_TYPE_STEREO` | Stereo channel |
-### CodecType
-| Value | Name |
-|-------|------|
-| 0 | `CODEC_TYPE_UNSPECIFIED` |
-| 1 | `CODEC_TYPE_VIDEO_VP8` |
-| 2 | `CODEC_TYPE_VIDEO_VP9` |
-| 3 | `CODEC_TYPE_VIDEO_AVC` |
-| 4 | `CODEC_TYPE_VIDEO_HEVC` |
-| 5 | `CODEC_TYPE_VIDEO_AV1` |
-| 64 | `CODEC_TYPE_AUDIO_OPUS` |
-| 65 | `CODEC_TYPE_AUDIO_AAC` |
-| 66 | `CODEC_TYPE_AUDIO_PCM` |
+### AudioChannelAddRequest
+Request to add a channel to an audio mixer.
-### MediaCodecData
 | Field | Type | Description |
 |-------|------|-------------|
-| `codec_type` | CodecType | Codec identifier |
-| `sample_rate` | uint32 | Audio sample rate |
-| `timebase_num` | uint32 | Timebase numerator |
-| `timebase_den` | uint32 | Timebase denominator |
-| `codec_profile` | uint32 | Codec profile |
-| `codec_level` | uint32 | Codec level |
-| `width` | uint32 | Video width |
-| `height` | uint32 | Video height |
-| `channels` | uint32 | Audio channels |
-| `bit_depth` | uint32 | Bit depth |
+| `mixer_id` |  string | Mixer ID |
+| `channel_config` |  AudioMixerChannel | Channel configuration |
+### AudioChannelPluginStatus
+Audio channel plugin status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string | Plugin ID |
+| `type` |  string | Plugin type |
+| `params` | repeated AudioPluginParamStatus | Plugin parameter status |
+### AudioChannelRemoveRequest
+Request to remove a channel from an audio mixer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `mixer_id` |  string | Mixer ID |
+| `channel_id` |  string | Channel ID to remove |
+### AudioChannelStatus
+Audio channel status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string | Channel ID |
+| `output_type` |  AudioMixerChannelType | Output type |
+| `level` |  float | Channel level (0.0-1.0) |
+| `pan` |  float | Pan position |
+| `vu` | repeated float | VU meter values |
+| `has_data` |  bool | Has audio data |
+| `read_errors` |  uint32 | Read error count |
+| `plugins` | repeated AudioChannelPluginStatus | Plugin status |
+### AudioMixerAddRequest
+Request to add a new audio mixer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string | Unique mixer ID |
+| `config` |  AudioMixerConfig | Mixer configuration |
+### AudioMixerChannel
+Audio mixer channel configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string | Channel ID |
+| `source_id` |  string | Source ID |
+| `channel_type` |  AudioMixerChannelType | Channel type |
+| `source_channels` | repeated uint32 | Source channel indices |
+| `level` |  float | Channel level (0.0-1.0) |
+| `pan` |  float | Pan position (-1.0 to 1.0) |
+| `plugins` | repeated AudioPlugin | Audio plugins |
+### AudioMixerConfig
+Audio mixer configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `channels` | repeated AudioMixerChannel | Mixer channels |
+| `output_type` |  AudioMixerChannelType | Output channel type |
+| `order` |  uint32 | Processing order |
+### AudioMixerRemoveRequest
+Request to remove an audio mixer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string | Mixer ID to remove |
+### AudioMixerStatus
+Audio mixer status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string | Mixer ID |
+| `output_type` |  AudioMixerChannelType | Output type |
+| `vu` | repeated float | Master VU meter values |
+| `channels` | repeated AudioChannelStatus | Channel status |
+### AudioMixerUpdateRequest
+Request to update an existing audio mixer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string | Mixer ID to update |
+| `config` |  AudioMixerConfig | New configuration |
+### AudioPlugin
+Audio plugin instance.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string | Plugin instance ID |
+| `type` |  string | Plugin type |
+| `params` | repeated AudioPluginParam | Plugin parameters |
+| `aux_input_mix_ids` | repeated string | Auxiliary input mixer IDs |
+### AudioPluginParam
+Audio plugin parameter.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  uint32 | Parameter ID |
+| `float_value` |  float | Parameter value |
+### AudioPluginParamStatus
+Audio plugin parameter status (with display info).
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  uint32 | Parameter ID |
+| `float_value` |  float | Parameter value |
+| `label` |  string | Parameter label |
+| `display_value` |  string | Formatted display value |
+---
+## 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 | List of commands |
+### CommandListItem
+Command list item.
+Each item represents a single command to execute at a specific time offset.
-### FrameHeader
 | Field | Type | Description |
 |-------|------|-------------|
-| `type` | FrameType | Frame type |
-| `pts` | uint64 | Presentation timestamp |
-| `id` | uint64 | Frame ID |
-| `keyframe` | bool | Is keyframe |
-| `codec_data` | MediaCodecData | Codec parameters |
-| `routing_metadata` | string | Source routing (inbound only) |
+| `time_offset_us` |  int64 | Time offset in microseconds |
+| `add_source` |  sesame.v1.sources.SourceAddRequest | Source commands |
+| `update_source` |  sesame.v1.sources.SourceUpdateRequest |  |
+| `remove_source` |  sesame.v1.sources.SourceRemoveRequest |  |
+| `add_output` |  sesame.v1.outputs.OutputAddRequest | Output commands |
+| `update_output` |  sesame.v1.outputs.OutputUpdateRequest |  |
+| `remove_output` |  sesame.v1.outputs.OutputRemoveRequest |  |
+| `add_compositor` |  sesame.v1.compositor.CompositorAddRequest | Compositor commands |
+| `remove_compositor` |  sesame.v1.compositor.CompositorRemoveRequest |  |
+| `clear_compositor` |  sesame.v1.compositor.CompositorClearRequest |  |
+| `add_node` |  sesame.v1.compositor.NodeAddRequest | Node commands |
+| `remove_node` |  sesame.v1.compositor.NodeRemoveRequest |  |
+| `set_property` |  sesame.v1.compositor.PropertySetRequest | Property commands |
+| `animate_property` |  sesame.v1.compositor.PropertyAnimateRequest |  |
+| `add_audio_mixer` |  sesame.v1.audio.AudioMixerAddRequest | Audio mixer commands |
+| `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 | Source transport commands |
+| `load_playlist` |  sesame.v1.sources.LoadPlaylistRequest | Recorder playlist commands |
+| `eject_playlist` |  sesame.v1.sources.EjectPlaylistRequest |  |
+| `callback` |  sesame.v1.common.Callback | Callback command |
+| `set_source_metadata` |  sesame.v1.sources.SourceMetadataSetRequest | Source metadata command |
+| `transaction_id` | optional uint32 | Transaction ID for grouping |
+| `transaction_deps` | repeated uint32 | Transaction dependencies |
 ---
-## Common Types
+## 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` | Invalid |
+| 0 | `CONNECTION_STATE_UNSPECIFIED` | Unspecified |
 | 1 | `CONNECTION_STATE_INITIALIZING` | Initializing resources |
 | 2 | `CONNECTION_STATE_CONNECTING` | Connecting/opening |
 | 3 | `CONNECTION_STATE_ONLINE` | Healthy and running |
@@ -109,208 +322,1089 @@ Every WebSocket message is framed as:
 | 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` | Invalid |
+| 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 |
-### CodecId
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `CODEC_ID_UNSPECIFIED` | Invalid |
-| 1 | `CODEC_ID_H264` | H.264/AVC |
-| 2 | `CODEC_ID_HEVC` | H.265/HEVC |
-| 3 | `CODEC_ID_AV1` | AV1 |
-| 4 | `CODEC_ID_VP8` | VP8 |
-| 5 | `CODEC_ID_PRORES` | Apple ProRes |
-| 6 | `CODEC_ID_DNXHR` | Avid DNxHR |
+### Callback
-### EventTopic
+Callback message for event notifications.
+Used to trigger client-side callbacks when specific events occur.
-| Value | Name | Description |
+| Field | Type | Description |
 |-------|------|-------------|
-| 0 | `EVENT_TOPIC_UNSPECIFIED` | Invalid |
-| 1 | `EVENT_TOPIC_ERROR` | Error events |
-| 2 | `EVENT_TOPIC_TRANSPORT` | Source transport state changes |
-| 3 | `EVENT_TOPIC_CALLBACK` | Client callback events |
-| 4 | `EVENT_TOPIC_JOB` | Job lifecycle and progress events |
-| 6 | `EVENT_TOPIC_RECORDER` | Recorder events |
+| `event` |  string | Event name/identifier |
+| `data` |  string | Event data (JSON or other format) |
+### 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.
-### Vec4
 | Field | Type | Description |
 |-------|------|-------------|
-| `x` | float | Red / X |
-| `y` | float | Green / Y |
-| `z` | float | Blue / Z |
-| `w` | float | Alpha / W |
+| `name` |  string | Key name |
+| `value` |  PropValue | Value as string |
 ### PropValue
-Oneof `value`:
+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 | Floating point value |
-| `vec4_value` | Vec4 | Vector value |
-| `string_value` | string | String value |
-| `bool_value` | bool | Boolean value |
-| `int_value` | int32 | Integer value |
+| `float_value` |  float | Floating point value (opacity, volume, etc.) |
+| `vec4_value` |  Vec4 | Vector value (color, position, etc.) |
+| `string_value` |  string | String value (text content, URLs, etc.) |
+| `bool_value` |  bool | Boolean value (enabled/disabled flags) |
+| `int_value` |  int32 | Integer value (indices, counts, etc.) |
 ### PropertyDomain
-Identifies which engine object owns the property. Oneof `owner`:
+Property domain (compositor, audio mixer, etc.).
+Used for property set/animate operations across different domains.
 | Field | Type | Description |
 |-------|------|-------------|
-| `compositor_id` | string | Scene graph node/effect |
-| `audio_mixer_id` | string | Audio mixer channel/plugin |
-| `source_id` | string | Source preprocessor |
-| `replay_id` | string | Replay (reserved) |
+| `compositor_id` |  string | Compositor ID |
+| `audio_mixer_id` |  string | Audio mixer ID |
+| `replay_id` |  string | Replay ID |
+| `source_id` |  string | Source ID |
+### TransportMetadata
+Transport metadata (timecode, etc.).
+Used for source and recorder metadata operations.
+| Field | Type | Description |
+|-------|------|-------------|
+| `items` | repeated NameValue | Metadata items |
+### 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.
-### Callback
 | Field | Type | Description |
 |-------|------|-------------|
-| `event` | string | Event name identifier |
-| `data` | string | Event data (JSON or other) |
+| `x` |  float | Red component for colors, X position for coordinates |
+| `y` |  float | Green component for colors, Y position for coordinates |
+| `z` |  float | Blue component for colors, Z position for coordinates |
+| `w` |  float | Alpha component for colors, W component for coordinates |
 ---
-## RPC Envelope
-`sesame.v1.rpc`
+## sesame/v1/compositor/compositor.proto
-### Message
+`sesame.v1.compositor`
-Oneof `payload`:
-| Field | Type | Description |
+### AnimationChannelEvaluationMode
+Animation channel evaluation mode.
+| Value | Name | Description |
 |-------|------|-------------|
-| `request` | Request | Client → server request |
-| `response` | Response | Server → client response |
-| `event` | Event | Server → client push event |
+| 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) |
-### Request
-| Field | Type | Description |
+### NodeType
+Node type in the scene graph.
+| Value | Name | Description |
 |-------|------|-------------|
-| `method` | string | RPC method name (e.g. `"ExecuteCommandList"`) |
-| `seq` | uint32 | Sequence number for response matching |
-| `payload` | bytes | Serialized request protobuf |
+| 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.
-### Response
 | Field | Type | Description |
 |-------|------|-------------|
-| `seq` | uint32 | Sequence number matching request |
-| `ok` | bool | Success flag |
-| `payload` | bytes | Serialized response protobuf |
-| `error` | string | Error message (when `ok` is false) |
+| `id` |  string | Unique compositor ID |
+| `multisample` |  bool | Enable multisampling (anti-aliasing) |
+| `width` |  uint32 | Compositor width |
+| `height` |  uint32 | Compositor height |
+### CompositorClearRequest
+Request to clear a compositor (remove all nodes).
-### Event
 | Field | Type | Description |
 |-------|------|-------------|
-| `topic` | EventTopic | Event topic |
-| `payload` | bytes | Serialized `status.Event` protobuf |
+| `id` |  string | Compositor ID to clear |
----
-## Commands
+### CompositorRemoveRequest
-`sesame.v1.commands`
+Request to remove a compositor.
-Commands are batched into a `CommandList` and executed atomically via `ExecuteCommandList`.
-### CommandListItem
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string | Compositor ID to remove |
+### KeyFrame
+Animation keyframe.
 | Field | Type | Description |
 |-------|------|-------------|
-| `time_offset_us` | int64 | Schedule time offset (microseconds) |
-| `transaction_id` | uint32? | Optional transaction group ID |
-| `transaction_deps` | uint32[] | Transaction dependencies |
-Oneof `item` — exactly one per command:
-| Field | Type | Category |
-|-------|------|----------|
-| `add_source` | SourceAddRequest | Source |
-| `update_source` | SourceUpdateRequest | Source |
-| `remove_source` | SourceRemoveRequest | Source |
-| `add_output` | OutputAddRequest | Output |
-| `update_output` | OutputUpdateRequest | Output |
-| `remove_output` | OutputRemoveRequest | Output |
-| `add_compositor` | CompositorAddRequest | Compositor |
-| `remove_compositor` | CompositorRemoveRequest | Compositor |
-| `clear_compositor` | CompositorClearRequest | Compositor |
-| `add_node` | NodeAddRequest | Scene graph |
-| `remove_node` | NodeRemoveRequest | Scene graph |
-| `set_property` | PropertySetRequest | Property |
-| `animate_property` | PropertyAnimateRequest | Property |
-| `add_audio_mixer` | AudioMixerAddRequest | Audio |
-| `update_audio_mixer` | AudioMixerUpdateRequest | Audio |
-| `remove_audio_mixer` | AudioMixerRemoveRequest | Audio |
-| `add_audio_channel` | AudioChannelAddRequest | Audio |
-| `remove_audio_channel` | AudioChannelRemoveRequest | Audio |
-| `update_source_transport` | SourceTransportCommand | Transport |
-| `load_playlist` | LoadPlaylistRequest | Playlist |
-| `eject_playlist` | EjectPlaylistRequest | Playlist |
-| `callback` | Callback | Callback |
-| `set_source_metadata` | SourceMetadataSetRequest | Metadata |
+| `time_us` |  int64 | Keyframe time in microseconds |
+| `value` |  sesame.v1.common.PropValue | Keyframe value |
+| `easing_in` |  string | Easing function for incoming interpolation |
+| `easing_out` |  string | Easing function for outgoing interpolation |
----
-## Sources
+### NodeAddRequest
-`sesame.v1.sources`
+Request to add a node to the scene graph.
-### SourceType
-| Value | Name | Description |
+| Field | Type | Description |
 |-------|------|-------------|
-| 0 | `SOURCE_TYPE_UNSPECIFIED` | Invalid |
-| 1 | `SOURCE_TYPE_FILE` | File playback |
-| 2 | `SOURCE_TYPE_RECORDER` | Recorder playback |
-| 3 | `SOURCE_TYPE_BROWSER` | CEF browser |
-| 4 | `SOURCE_TYPE_RTT` | Render-to-texture |
-| 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 |
+| `compositor_id` |  string | Compositor ID |
+| `parent_address` |  string | Parent node address (e.g., "root/layer1") |
+| `node_id` |  string | New node ID |
+| `node_type` |  NodeType | Node type |
-### SourceTransportState
-| Value | Name | Description |
+### NodeRemoveRequest
+Request to remove a node from the scene graph.
+| Field | Type | 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) |
+| `compositor_id` |  string | Compositor ID |
+| `address` |  string | Node address to remove |
-### SourceTransportCommandType
-| Value | Name | Description |
+### PropertyAnimateRequest
+Request to animate a property.
+| Field | Type | Description |
 |-------|------|-------------|
-| 0 | `SOURCE_TRANSPORT_CMD_UNSPECIFIED` | Invalid |
-| 1 | `SOURCE_TRANSPORT_CMD_STOP` | Stop playback |
-| 2 | `SOURCE_TRANSPORT_CMD_PLAY` | Start playback |
+| `domain` |  sesame.v1.common.PropertyDomain | Property domain |
+| `address` |  string | Node address |
+| `property` |  string | Property name |
+| `keyframes` | repeated KeyFrame | Animation keyframes |
+| `before` |  AnimationChannelEvaluationMode | Evaluation mode before first keyframe |
+| `after` |  AnimationChannelEvaluationMode | Evaluation mode after last keyframe |
+### PropertySetRequest
+Request to set a property value.
+| Field | Type | Description |
+|-------|------|-------------|
+| `domain` |  sesame.v1.common.PropertyDomain | Property domain |
+| `address` |  string | Node address |
+| `property` |  string | Property name |
+| `value` |  sesame.v1.common.PropValue | Property value |
+---
+## 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 | Output filename |
+| `container` |  ContainerFormat | Output container format |
+| `video_codec` |  sesame.v1.common.CodecType | Video codec |
+| `width` |  uint32 | Output width |
+| `height` |  uint32 | Output height |
+| `fps_num` |  uint32 | Frame rate numerator |
+| `fps_den` |  uint32 | Frame rate denominator |
+| `rate_control` |  RateControlMode | Video rate control mode |
+| `video_bitrate_kbps` |  uint32 | Target video bitrate (kbps) |
+| `max_video_bitrate_kbps` |  uint32 | Peak video bitrate cap (kbps) |
+| `gop_size` |  uint32 | GOP size in frames |
+| `max_b_frames` |  uint32 | Maximum B-frames |
+| `profile` |  string | Codec profile (e.g. main, high) |
+| `level` |  string | Codec level (e.g. 4.1, 5.1) |
+| `pixel_format` |  string | Pixel format (e.g. yuv420p) |
+| `color_primaries` |  string | Color primaries (e.g. bt709) |
+| `color_transfer` |  string | Transfer characteristics (e.g. bt709) |
+| `color_matrix` |  string | Matrix coefficients (e.g. bt709) |
+| `full_range` |  bool | Full range if true, limited if false |
+| `audio_codec` |  sesame.v1.common.CodecType | Audio codec |
+| `audio_bitrate_kbps` |  uint32 | Audio bitrate (kbps) |
+| `audio_sample_rate_hz` |  uint32 | Audio sample rate (Hz) |
+| `audio_channels` |  uint32 | Number of audio channels |
+| `audio_routing` | repeated uint32 | Audio channel routing |
+### ExportStartRequest
+Request to start playlist export.
+| Field | Type | Description |
+|-------|------|-------------|
+| `config` |  ExportConfiguration | Export configuration |
+| `items` | repeated sesame.v1.recorder.PlaylistItem | Playlist items |
+### ImportConfiguration
+Clip import configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `src_filename` |  string | Source filename |
+| `audio_routing` | repeated uint32 | Audio channel routing |
+| `dst_recorder_id` |  string | Destination recorder ID |
+| `dst_clip_id` |  uint64 | Destination clip ID |
+| `dst_clip_name` |  string | Destination clip name |
+| `dst_clip_user_data` |  string | Destination clip user data |
+### ImportStartRequest
+Request to start clip import.
+| Field | Type | Description |
+|-------|------|-------------|
+| `config` |  ImportConfiguration | Import configuration |
+### Job
+A job. Used as RPC response, list item, and event payload.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  uint32 | Job ID |
+| `type` |  JobType | Job type |
+| `status` |  JobStatus | Current status |
+| `name` |  string | Job name (e.g. "Export playlist") |
+| `description` |  string | Job description (e.g. filename) |
+| `error` | optional string | Error message (if status == ERROR) |
+| `progress` |  int64 | Current progress (us) |
+| `total` |  int64 | Total duration (us) |
+| `timing_info` | optional TimingInfo | Timing info (set on completion for imports) |
+### JobAbortRequest
+Request to abort a job.
+| Field | Type | Description |
+|-------|------|-------------|
+| `job_id` |  uint32 | Job ID to abort |
+### 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 | Playlist export |
+| `import_request` |  ImportStartRequest | Clip import |
+### JobStatusRequest
+Request to get job status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `job_id` |  uint32 | Job ID |
+### TimingInfo
+Timing information for clips.
+| Field | Type | Description |
+|-------|------|-------------|
+| `tc_in` |  int64 | In timecode (us) |
+| `tc_out` |  int64 | Out timecode (us) |
+---
+## 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 | Decklink device index |
+| `video_format` |  sesame.v1.common.VideoFormat | Video format |
+| `key_and_fill` |  bool | Key and fill mode |
+### EncodedMoqOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `encoder` |  EncoderConfig | Encoded transport settings |
+| `url` |  string | MoQ URL |
+| `broadcast` |  string | Broadcast namespace |
+| `key` |  string | Authentication key |
+### EncodedRecorderOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `encoder` |  EncoderConfig | Encoded transport settings |
+| `filename` |  string | Base filename |
+| `size_gb` |  uint32 | Maximum size in GB |
+| `group_id` |  string | Group ID for organization |
+| `recorder_type` |  RecorderType | Recorder type |
+### EncodedSrtOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `url` |  string | SRT URL |
+| `encoder` |  EncoderConfig | Encoded transport settings |
+### EncodedSuperSlowMoRecorderOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `encoder` |  EncoderConfig | Encoded transport settings |
+| `filename` |  string | Base filename |
+| `size_gb` |  uint32 | Maximum size in GB |
+| `group_id` |  string | Group ID |
+| `recorder_type` |  RecorderType | Recorder type |
+| `composition_ids` | repeated string | Compositor IDs to record |
+| `source_ids` | repeated string | Source IDs to record |
+### EncodedWebSocketOutputConfig
+-----------------------------------------------------------------------------
+Type-specific output payloads
+-----------------------------------------------------------------------------
+| Field | Type | Description |
+|-------|------|-------------|
+| `channel` |  string | WebSocket channel/topic |
+| `encoder` |  EncoderConfig | Encoded transport settings |
+### EncoderConfig
+Encoded output configuration (WebSocket, SRT, MoQ).
+| Field | Type | Description |
+|-------|------|-------------|
+| `codec` |  sesame.v1.common.CodecType | Encoder codec |
+| `preset` |  EncoderPreset | Encoder preset |
+| `bitrate_kbps` |  uint32 | Bitrate in kbps |
+| `keyframe_interval` |  uint32 | GOP length in frames (0 = codec/preset default) |
+| `width` |  uint32 | Video width |
+| `height` |  uint32 | Video height |
+| `fps` |  float | Video framerate |
+### KeyframeRequest
+Keyframe request for encoder.
+Requests an immediate keyframe (IDR frame) from an encoder output.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string | ID of the output to request keyframe from |
+### OutputAddRequest
+Request to add a new output.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string | Unique output ID |
+| `composition_id` |  string | Compositor ID to output |
+| `audio_mix_ids` | repeated string | Audio mixer IDs |
+| `use_as_clock` |  bool | Use as master clock |
+| `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 | Output ID to remove |
+### OutputStatus
+Output status information.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string | Output ID |
+| `type` |  OutputType | Output type |
+| `state` |  sesame.v1.common.ConnectionState | Connection/lifecycle state |
+| `msg` | optional string | Error message (typically when state == ERROR) |
+| `url` |  string | Output URL |
+| `buffer_size` |  uint32 | Buffer size (frames) |
+| `srt_stats` | optional sesame.v1.status.SRTSendStatistics | SRT stats (if SRT output) |
+### OutputUpdateRequest
+Request to update an existing output.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string | Output ID to update |
+| `composition_id` |  string | Compositor ID |
+| `audio_mix_ids` | repeated string | Audio mixer IDs |
+| `use_as_clock` |  bool | Use as master clock |
+| `websocket` |  EncodedWebSocketOutputConfig |  |
+| `recorder` |  EncodedRecorderOutputConfig |  |
+| `super_slowmo_recorder` |  EncodedSuperSlowMoRecorderOutputConfig |  |
+| `srt` |  EncodedSrtOutputConfig |  |
+| `moq` |  EncodedMoqOutputConfig |  |
+| `decklink` |  DecklinkOutputConfig |  |
+| `system_audio` |  SystemAudioOutputConfig |  |
+### SystemAudioOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `device_name` |  string | System audio device settings |
+---
+## 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 | Recorder ID |
+| `id` |  uint64 | Clip ID |
+| `transition_time_us` |  int64 | Transition duration (us) |
+| `transition_type` |  TransitionType | Transition type |
+| `transition_fade_color` |  sesame.v1.common.Vec4 | Fade color |
+| `speed` |  float | Playback speed |
+| `audio_routing` | repeated uint32 | Audio routing |
+| `start_time_us` | optional int64 | Start time (us) |
+| `end_time_us` | optional int64 | End time (us) |
+| `audio_levels` | repeated float | Audio levels per channel (0.0-1.0) |
+### RecorderClip
+Recorder clip information.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  uint64 | Clip ID |
+| `name` |  string | Clip name |
+| `user_data` |  string | User-defined data |
+| `flags` |  uint64 | Clip flags (bitfield) |
+| `start_time_us` |  int64 | Start time (us) |
+| `end_time_us` |  int64 | End time (us) |
+| `locked_start_us` |  int64 | Locked start time (us) |
+| `locked_end_us` |  int64 | Locked end time (us) |
+| `user_time_us` |  int64 | User-defined timecode (us) |
+### RecorderClipAddRequest
+Request to add a clip to a recorder.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clip` |  RecorderClip | Clip to add |
+### RecorderClipCopyRequest
+Request to copy a clip.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clip_id` |  uint64 | Source clip ID |
+| `new_clip_id` |  uint64 | Destination clip ID |
+### RecorderClipFlagSetRequest
+Request to set a clip flag.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clip_id` |  uint64 | Clip ID |
+| `flag` |  uint64 | Flag to set/clear |
+| `value` |  bool | Flag value |
+### RecorderClipRange
+Clip id range.
+| Field | Type | Description |
+|-------|------|-------------|
+| `low` |  uint64 | Low clip ID |
+| `high` |  uint64 | High clip ID |
+### RecorderClipRemoveRequest
+Request to remove a clip.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clip_id` |  uint64 | Clip ID to remove |
+### RecorderClipsClearRequest
+Request to clear clips with filters.
+| Field | Type | Description |
+|-------|------|-------------|
+| `protected_ranges` | repeated RecorderClipRange | Protected time ranges |
+| `must_have_flags` |  uint64 | Clips must have these flags |
+| `must_not_have_flags` |  uint64 | Clips must not have these flags |
+### RecorderClipsGetRequest
+Request to get all clips from a recorder.
+Empty - returns all clips
+### RecorderClipsGetResponse
+Response with recorder clips.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clips` | repeated RecorderClip | List of clips |
+### RecorderClipsVerifyRequest
+Request to verify clip integrity.
+Empty - verifies all clips
+### RecorderClipsVerifyResponse
+Response with verification errors.
+| Field | Type | Description |
+|-------|------|-------------|
+| `errors` | repeated string | List of errors |
+### RecorderEvent
+Recorder event notification.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string | Recorder ID |
+| `online` |  bool | Is recorder online |
+| `message` | optional string | Event message |
+### RecorderLockedDurationSetRequest
+Request to set locked duration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `frames` |  uint32 | Locked duration in frames |
+### RecorderMetadataSetRequest
+Request to set recorder metadata.
+| Field | Type | Description |
+|-------|------|-------------|
+| `metadata` |  sesame.v1.common.TransportMetadata | Metadata to set |
+### RecorderOkResponse
+Generic OK response.
+Empty - indicates success
+### RecorderRequest
+Recorder request wrapper.
+| Field | Type | Description |
+|-------|------|-------------|
+| `recorder_id` |  string | Recorder ID |
+| `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 | Recorder ID |
+---
+## sesame/v1/rpc/rpc.proto
+`sesame.v1.rpc`
+### Event
+Server event notification.
+| Field | Type | Description |
+|-------|------|-------------|
+| `topic` |  sesame.v1.common.EventTopic | Event topic (typed) |
+| `payload` |  bytes | Serialized event payload |
+### 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 | Client request |
+| `response` |  Response | Server response |
+| `event` |  Event | Server event |
+### Request
+RPC request from client to server.
+| Field | Type | Description |
+|-------|------|-------------|
+| `method` |  string | RPC method name |
+| `seq` |  uint32 | Sequence number for matching responses |
+| `payload` |  bytes | Serialized request payload |
+### 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 | Sequence number matching request |
+| `ok` |  bool | Success flag |
+| `payload` |  bytes | Serialized response payload |
+| `error` |  string | Error message (if ok == false) |
+---
+## 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 |
+| 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) |
+| 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 |
@@ -318,786 +1412,645 @@ Oneof `item` — exactly one per command:
 | 14 | `SOURCE_TRANSPORT_CMD_TRANSITIONS_DISABLED` | Disable transitions |
 | 15 | `SOURCE_TRANSPORT_CMD_SET_SCRUBBING` | Set scrubbing mode |
-### DecoderType
-| Value | Name |
-|-------|------|
-| 0 | `DECODER_TYPE_UNSPECIFIED` |
-| 1 | `DECODER_TYPE_H264` |
-| 2 | `DECODER_TYPE_HEVC` |
-| 3 | `DECODER_TYPE_AV1` |
+### 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 | Initial page URL |
+| `width` |  uint32 | Optional browser width hint |
+| `height` |  uint32 | Optional browser height hint |
+### DecklinkSourceConfig
+Decklink source configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `device_index` |  uint32 | Decklink device index |
+| `video_format` |  sesame.v1.common.VideoFormat | Video format |
+| `sync_group` | optional uint32 | Sync group for genlock |
+### EjectPlaylistRequest
+Request to eject playlist from recorder source.
+| Field | Type | Description |
+|-------|------|-------------|
+| `source_id` |  string | Source ID |
+### FileSourceConfig
+Type-specific source payloads.
+| Field | Type | Description |
+|-------|------|-------------|
+| `url` |  string | File URL/path |
+### LoadPlaylistRequest
+Request to load a playlist into a recorder source.
+| Field | Type | Description |
+|-------|------|-------------|
+| `source_id` |  string | Source ID |
+| `user_playlist_id` |  string | User playlist ID |
+| `items` | repeated sesame.v1.recorder.PlaylistItem | Playlist items |
+| `start_time_us` | optional int64 | Start time (us) |
+| `start_index` | optional int64 | Start item index |
+| `material_pos_us` | optional int64 | Material position (us) |
+### MoqSourceConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `url` |  string | MoQ relay URL |
+| `broadcast` |  string | Broadcast namespace |
+| `key` |  string | Authentication key |
+| `decode_buffer_frames` |  uint32 | Live buffer size in frames (0 = use default) |
+### RTTSourceConfig
+RTT (Render-to-Texture) source configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `rtt_id` |  string | ID of the RTT render target to display |
+| `audio_mixes` | repeated string | Audio mixer IDs to include |
+| `delay_frames` |  uint32 | Delay in frames |
+### RecorderSourceConfig
-### DeinterlaceType
+| Field | Type | Description |
+|-------|------|-------------|
+| `recorder_id` |  string | Recorder ID |
+| `codec` |  sesame.v1.common.CodecType | Preferred hardware decoder codec |
-| Value | Name |
-|-------|------|
-| 0 | `DEINTERLACE_TYPE_PROGRESSIVE` |
-| 1 | `DEINTERLACE_TYPE_UPPER_FIELD_FIRST` |
-| 2 | `DEINTERLACE_TYPE_LOWER_FIELD_FIRST` |
-| 3 | `DEINTERLACE_TYPE_AUTO` |
-### SourceTextureSize
+### SignalGeneratorSourceConfig
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `SOURCE_TEXTURE_SIZE_UNSPECIFIED` | Default |
-| 1 | `SOURCE_TEXTURE_SIZE_HD` | 1920×1080 |
-| 2 | `SOURCE_TEXTURE_SIZE_4K` | 3840×2160 |
-### PreprocessStep
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `PREPROCESS_STEP_UNSPECIFIED` | Invalid |
-| 1 | `PREPROCESS_STEP_VIDEO_SCOPES` | Video scopes/waveform |
-| 2 | `PREPROCESS_STEP_CHROMA_KEY` | Chroma key |
-| 3 | `PREPROCESS_STEP_BLUR` | Blur effect |
-### SourceCommonConfig
+### SourceAddRequest
+Request to add a new source.
-Shared settings for all source types.
 | Field | Type | Description |
 |-------|------|-------------|
-| `user_id` | string | User-defined ID |
-| `use_as_clock` | bool | Use as master clock source |
-| `audio_only` | bool | Audio-only mode |
-| `audio_channels` | uint32 | Expected audio channel count |
-| `loop` | bool | Loop playback |
-| `play_state` | SourceTransportState | Initial playback state |
-| `mip_map` | bool | Generate mipmaps |
-| `texture_size` | SourceTextureSize | GPU texture size |
-| `deinterlace` | DeinterlaceType | Deinterlace mode |
-| `video_processors` | VideoProcessor[] | Video preprocessors |
+| `id` |  string | Unique source ID |
+| `config` |  SourceConfig | Source configuration |
+### SourceCommonConfig
+Shared fields for all source kinds.
-### SourceConfig
 | Field | Type | Description |
 |-------|------|-------------|
-| `common` | SourceCommonConfig | Shared settings |
+| `user_id` |  string | User-defined ID |
+| `use_as_clock` |  bool | Use as master clock |
+| `audio_only` |  bool | Audio-only mode |
+| `audio_channels` |  uint32 | Requested/expected audio channel count |
+| `loop` |  bool | Loop playback (if applicable) |
+| `play_state` |  SourceTransportState | Initial playback state |
+| `mip_map` |  bool | Generate mipmaps |
+| `texture_size` |  SourceTextureSize | Texture size for GPU upload |
+| `deinterlace` |  DeinterlaceType | Deinterlace mode |
+| `video_processors` | repeated VideoProcessor | Video processors |
-Oneof `details` — exactly one required:
-| Field | Type | Source type |
-|-------|------|------------|
-| `file` | FileSourceConfig | `SOURCE_TYPE_FILE` |
-| `recorder` | RecorderSourceConfig | `SOURCE_TYPE_RECORDER` |
-| `browser` | BrowserSourceConfig | `SOURCE_TYPE_BROWSER` |
-| `rtt` | RTTSourceConfig | `SOURCE_TYPE_RTT` |
-| `decklink` | DecklinkSourceConfig | `SOURCE_TYPE_DECKLINK` |
-| `signal_generator` | SignalGeneratorSourceConfig | `SOURCE_TYPE_SIGNAL_GENERATOR` |
-| `system_audio` | SystemAudioSourceConfig | `SOURCE_TYPE_SYSTEM_AUDIO` |
-| `srt_stream` | SrtSourceConfig | `SOURCE_TYPE_SRT_STREAM` |
-| `websocket` | WebsocketSourceConfig | `SOURCE_TYPE_WEBSOCKET` |
-| `moq` | MoqSourceConfig | `SOURCE_TYPE_MOQ` |
+### SourceConfig
-### Source Type Configs
+Source configuration.
+Defines how a source is created and configured.
-**FileSourceConfig** — `{ url: string }`
-**RecorderSourceConfig** — `{ recorder_id: string, decoder_type: DecoderType }`
+| Field | Type | Description |
+|-------|------|-------------|
+| `common` |  SourceCommonConfig | Shared source settings |
+| `file` |  FileSourceConfig | SOURCE_TYPE_FILE |
+| `recorder` |  RecorderSourceConfig | SOURCE_TYPE_RECORDER |
+| `browser` |  BrowserSourceConfig | SOURCE_TYPE_BROWSER |
+| `rtt` |  RTTSourceConfig | SOURCE_TYPE_RTT |
+| `decklink` |  DecklinkSourceConfig | SOURCE_TYPE_DECKLINK |
+| `signal_generator` |  SignalGeneratorSourceConfig | SOURCE_TYPE_SIGNAL_GENERATOR |
+| `system_audio` |  SystemAudioSourceConfig | SOURCE_TYPE_SYSTEM_AUDIO |
+| `srt_stream` |  SrtSourceConfig | SOURCE_TYPE_SRT_STREAM |
+| `websocket` |  WebsocketSourceConfig | SOURCE_TYPE_WEBSOCKET |
+| `moq` |  MoqSourceConfig | SOURCE_TYPE_MOQ |
-**BrowserSourceConfig** — `{ url: string, width?: uint32, height?: uint32 }`
-**RTTSourceConfig** — `{ rtt_id: string, audio_mixes: string[], delay_frames: uint32 }`
+### SourceMetadataEvent
-**DecklinkSourceConfig** — `{ device_index: uint32, video_format: VideoFormat, sync_group?: uint32 }`
+Source metadata transport event notification.
-**SignalGeneratorSourceConfig** — `{}` (no fields)
-**SystemAudioSourceConfig** — `{ device_name: string }` (empty = default device)
+| Field | Type | Description |
+|-------|------|-------------|
+| `source_id` |  string | Source ID |
+| `metadata` |  sesame.v1.common.TransportMetadata | Event metadata |
-**SrtSourceConfig** — `{ url: string, decode_buffer_frames: uint32 }`
-**WebsocketSourceConfig** — `{ channel: string, decode_buffer_frames: uint32 }`
+### SourceMetadataSetRequest
-**MoqSourceConfig** — `{ url: string, broadcast: string, key: string, decode_buffer_frames: uint32 }`
+Request to set source metadata.
-### SourceTransportCommand
 | Field | Type | Description |
 |-------|------|-------------|
-| `source_id` | string | Source ID |
-| `cmd_type` | SourceTransportCommandType | Command type |
-| `value` | PropValue | Command value |
+| `source_id` |  string | Source ID |
+| `metadata` |  sesame.v1.common.TransportMetadata | Metadata to set |
-### LoadPlaylistRequest
-| Field | Type | Description |
-|-------|------|-------------|
-| `source_id` | string | Recorder source ID |
-| `user_playlist_id` | string | User playlist ID |
-| `items` | PlaylistItem[] | Playlist items |
-| `start_time_us` | int64? | Start time (μs) |
-| `start_index` | int64? | Start item index |
-| `material_pos_us` | int64? | Material position (μs) |
+### SourceRemoveRequest
+Request to remove a source.
-### SourceStatus
 | Field | Type | Description |
 |-------|------|-------------|
-| `id` | string | Source ID |
-| `type` | SourceType | Source type |
-| `user_id` | string | User-defined ID |
-| `state` | ConnectionState | Connection state |
-| `transport_state` | SourceTransportState | Transport state |
-| `msg` | string? | Error message |
-| `url` | string | Current URL |
-| `width` | uint32 | Video width |
-| `height` | uint32 | Video height |
-| `fps` | float | Video framerate |
-| `duration_us` | int64 | Duration (μs) |
-| `play_position_us` | int64 | Playback position (μs) |
-| `video_buf` | int32 | Video buffer (frames) |
-| `audio_buf` | int32 | Audio buffer (frames) |
-| `gpu_buf` | int32 | GPU buffer (frames) |
-| `audio_channels` | uint32 | Active audio channels |
-| `audio_level` | float | Audio level (0–1) |
-| `lip_sync_offset_us` | int64 | Lip sync offset (μs) |
-| `decode_timing` | FrameTiming | Decode timing stats |
-| `video_buf_avg` | double | Average video buffer level |
-| `srt_stats` | SRTReceiveStatistics? | SRT stats (if SRT source) |
+| `id` |  string | Source ID to remove |
----
-## Outputs
+### SourceStatus
-`sesame.v1.outputs`
+Source status information.
-### OutputType
-| Value | Name | Description |
+| Field | Type | Description |
 |-------|------|-------------|
-| 0 | `OUTPUT_TYPE_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 |
+| `id` |  string | Source ID |
+| `type` |  SourceType | Source type |
+| `user_id` |  string | User-defined ID |
+| `state` |  sesame.v1.common.ConnectionState | Connection/lifecycle state |
+| `transport_state` |  SourceTransportState | Transport state |
+| `msg` | optional string | Error message (typically when state == ERROR) |
+| `url` |  string | Current URL |
+| `width` |  uint32 | Video width |
+| `height` |  uint32 | Video height |
+| `fps` |  float | Video framerate |
+| `duration_us` |  int64 | Duration (us) |
+| `play_position_us` |  int64 | Playback position (us) |
+| `video_buf` |  int32 | Video buffer level (frames) |
+| `audio_buf` |  int32 | Audio buffer level (frames) |
+| `gpu_buf` |  int32 | GPU buffer level (frames) |
+| `audio_channels` |  uint32 | Active audio channels |
+| `audio_level` |  float | Audio level (0.0-1.0) |
+| `lip_sync_offset_us` |  int64 | Lip sync offset (us) |
+| `decode_timing` |  sesame.v1.status.FrameTiming | Decode timing stats |
+| `video_buf_avg` |  double | Average video buffer level |
+| `srt_stats` | optional sesame.v1.status.SRTReceiveStatistics | SRT stats (if SRT source) |
-### RecorderType
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `RECORDER_TYPE_UNSPECIFIED` | Invalid |
-| 1 | `RECORDER_TYPE_LIVE` | Live recorder (circular buffer) |
-| 2 | `RECORDER_TYPE_CLIPS` | Clip recorder (ingested frames only) |
-### EncoderPreset
+### SourceTransportCommand
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `ENCODER_PRESET_UNSPECIFIED` | Invalid |
-| 1 | `ENCODER_PRESET_LOW_LATENCY` | Low-latency tune |
-| 2 | `ENCODER_PRESET_LOW_LATENCY_IDR_ONLY` | Low-latency, IDR-only GOP |
-| 3 | `ENCODER_PRESET_HIGH_QUALITY` | High-quality tune |
+Source transport command.
-### EncoderConfig
 | Field | Type | Description |
 |-------|------|-------------|
-| `codec_id` | CodecId | Encoder codec |
-| `preset` | EncoderPreset | Encoder preset |
-| `bitrate_kbps` | uint32 | Bitrate (kbps) |
-| `keyframe_interval` | uint32 | GOP size in frames (0 = default) |
-| `width` | uint32 | Video width |
-| `height` | uint32 | Video height |
-| `fps` | float | Video framerate |
+| `source_id` |  string | Source ID |
+| `cmd_type` |  SourceTransportCommandType | Command type |
+| `value` |  sesame.v1.common.PropValue | Command value |
+### SourceUpdateRequest
+Request to update an existing source.
-### OutputAddRequest
 | Field | Type | Description |
 |-------|------|-------------|
-| `id` | string | Unique output ID |
-| `composition_id` | string | Compositor to output |
-| `audio_mix_ids` | string[] | Audio mixer IDs |
-| `use_as_clock` | bool | Use as master clock |
+| `id` |  string | Source ID to update |
+| `config` |  SourceConfig | New configuration |
-Oneof `output` — exactly one required:
-| Field | Type |
-|-------|------|
-| `websocket` | EncodedWebSocketOutputConfig |
-| `recorder` | EncodedRecorderOutputConfig |
-| `super_slowmo_recorder` | EncodedSuperSlowMoRecorderOutputConfig |
-| `srt` | EncodedSrtOutputConfig |
-| `moq` | EncodedMoqOutputConfig |
-| `decklink` | DecklinkOutputConfig |
-| `system_audio` | SystemAudioOutputConfig |
+### SrtSourceConfig
-### Output Type Configs
-**EncodedWebSocketOutputConfig** — `{ channel: string, encoder: EncoderConfig }`
-**EncodedRecorderOutputConfig** — `{ encoder: EncoderConfig, filename: string, size_gb: uint32, group_id: string, recorder_type: RecorderType }`
-**EncodedSuperSlowMoRecorderOutputConfig** — Same as recorder + `{ composition_ids: string[], source_ids: string[] }`
+| Field | Type | Description |
+|-------|------|-------------|
+| `url` |  string | SRT URL |
+| `decode_buffer_frames` |  uint32 | Live buffer size in frames (0 = use default) |
-**EncodedSrtOutputConfig** — `{ url: string, encoder: EncoderConfig }`
-**EncodedMoqOutputConfig** — `{ encoder: EncoderConfig, url: string, broadcast: string, key: string }`
+### SystemAudioSourceConfig
-**DecklinkOutputConfig** — `{ device_index: uint32, video_format: VideoFormat, key_and_fill: bool }`
-**SystemAudioOutputConfig** — `{ device_name: string }`
-### OutputStatus
 | Field | Type | Description |
 |-------|------|-------------|
-| `id` | string | Output ID |
-| `type` | OutputType | Output type |
-| `state` | ConnectionState | Connection state |
-| `msg` | string? | Error message |
-| `url` | string | Output URL |
-| `buffer_size` | uint32 | Buffer size (frames) |
-| `srt_stats` | SRTSendStatistics? | SRT stats (if SRT output) |
+| `device_name` |  string | System input/output device name, empty for default |
----
-## Compositor & Scene Graph
+### VideoProcessor
-`sesame.v1.compositor`
+Video processor instance configuration.
-### NodeType
-| Value | Name | Description |
+| Field | Type | Description |
 |-------|------|-------------|
-| 0 | `NODE_TYPE_UNSPECIFIED` | Invalid |
-| 1 | `NODE_TYPE_GROUP` | Group container node |
-| 2 | `NODE_TYPE_TEXT` | Text overlay |
-| 3 | `NODE_TYPE_VIDEO_BOX` | Video source display |
-| 4 | `NODE_TYPE_IMAGE` | Image/texture |
-| 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 |
-### AnimationChannelEvaluationMode
+| `id` |  string | Unique instance ID |
+| `type` |  PreprocessStep | Processor type |
+| `params` | repeated VideoProcessorParam | Processor parameters |
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `ANIM_MODE_CONSTANT` | Hold last value |
-| 1 | `ANIM_MODE_STATE_FROM` | Use initial value |
-| 2 | `ANIM_MODE_LOOP` | Loop animation |
-| 3 | `ANIM_MODE_BOUNCE` | Ping-pong |
-### CompositorAddRequest
+### VideoProcessorParam
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` | string | Unique compositor ID |
-| `multisample` | bool | Enable MSAA |
-| `width` | uint32 | Width |
-| `height` | uint32 | Height |
+Video processor parameter (mirrors AudioPluginParam).
-### NodeAddRequest
 | Field | Type | Description |
 |-------|------|-------------|
-| `compositor_id` | string | Compositor ID |
-| `parent_address` | string | Parent node address |
-| `node_id` | string | New node ID |
-| `node_type` | NodeType | Node type |
+| `id` |  uint32 | Parameter ID |
+| `float_value` |  float | Parameter value |
-### PropertySetRequest
-| Field | Type | Description |
-|-------|------|-------------|
-| `domain` | PropertyDomain | Property domain (compositor, audio mixer, source) |
-| `address` | string | Node/effect/channel address |
-| `property` | string | Property name |
-| `value` | PropValue | Value to set |
+### WebsocketSourceConfig
-### PropertyAnimateRequest
-| Field | Type | Description |
-|-------|------|-------------|
-| `domain` | PropertyDomain | Property domain |
-| `address` | string | Node/effect address |
-| `property` | string | Property name |
-| `keyframes` | KeyFrame[] | Animation keyframes |
-| `before` | AnimationChannelEvaluationMode | Mode before first keyframe |
-| `after` | AnimationChannelEvaluationMode | Mode after last keyframe |
-### KeyFrame
 | Field | Type | Description |
 |-------|------|-------------|
-| `time_us` | int64 | Keyframe time (μs) |
-| `value` | PropValue | Keyframe value |
-| `easing_in` | string | Easing function in |
-| `easing_out` | string | Easing function out |
+| `channel` |  string | WebSocket channel/topic |
+| `decode_buffer_frames` |  uint32 | Live buffer size in frames (0 = use default) |
 ---
-## Audio Mixer
-`sesame.v1.audio`
+## sesame/v1/status/statistics.proto
-### AudioMixerChannelType
+`sesame.v1.status`
-| Value | Name |
-|-------|------|
-| 0 | `AUDIO_MIXER_CHANNEL_TYPE_UNSPECIFIED` |
-| 1 | `AUDIO_MIXER_CHANNEL_TYPE_MONO` |
-| 2 | `AUDIO_MIXER_CHANNEL_TYPE_STEREO` |
-### AudioMixerChannel
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` | string | Channel ID |
-| `source_id` | string | Source ID |
-| `channel_type` | AudioMixerChannelType | Channel type |
-| `source_channels` | uint32[] | Source channel indices |
-| `level` | float | Level (0–1) |
-| `pan` | float | Pan (−1 to 1) |
-| `plugins` | AudioPlugin[] | Audio plugins |
-### AudioPlugin
+### FrameTiming
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` | string | Plugin instance ID |
-| `type` | string | Plugin type (CLAP plugin ID) |
-| `params` | AudioPluginParam[] | Plugin parameters |
-| `aux_input_mix_ids` | string[] | Auxiliary input mixer IDs |
+Frame timing statistics.
+Used to monitor decode/encode/render performance.
+All times are in microseconds (us).
-### AudioMixerConfig
 | Field | Type | Description |
 |-------|------|-------------|
-| `channels` | AudioMixerChannel[] | Mixer channels |
-| `output_type` | AudioMixerChannelType | Output channel type |
-| `order` | uint32 | Processing order |
+| `frame_time` |  int32 | Current frame time (us) |
+| `frame_time_avg` |  int32 | Average frame time (us) |
+| `frame_time_min` |  int32 | Minimum frame time (us) |
+| `frame_time_max` |  int32 | Maximum frame time (us) |
-### AudioMixerStatus
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` | string | Mixer ID |
-| `output_type` | AudioMixerChannelType | Output type |
-| `vu` | float[] | Master VU meter values |
-| `channels` | AudioChannelStatus[] | Channel status |
+### MemoryDomainStats
+Memory domain statistics.
+Tracks memory usage for different allocation domains.
-### AudioChannelStatus
 | Field | Type | Description |
 |-------|------|-------------|
-| `id` | string | Channel ID |
-| `output_type` | AudioMixerChannelType | Output type |
-| `level` | float | Level |
-| `pan` | float | Pan |
-| `vu` | float[] | VU meter values |
-| `has_data` | bool | Has audio data |
-| `read_errors` | uint32 | Read error count |
-| `plugins` | AudioChannelPluginStatus[] | Plugin status |
----
+| `current_bytes` |  uint64 | Current allocated bytes |
+| `peak_bytes` |  uint64 | Peak allocated bytes |
+| `budget_bytes` |  uint64 | Budget/limit in bytes |
-## Recorder
-`sesame.v1.recorder`
-### TransitionType
+### SRTReceiveStatistics
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `TRANSITION_TYPE_MIX` | Mix/dissolve |
-| 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 |
+SRT receive statistics.
+Provides detailed metrics for SRT stream reception.
+Used for monitoring stream health and diagnosing issues.
-### RecorderClip
 | Field | Type | Description |
 |-------|------|-------------|
-| `id` | uint64 | Clip ID |
-| `name` | string | Clip name |
-| `user_data` | string | User-defined data |
-| `flags` | uint64 | Clip flags (bitfield) |
-| `start_time_us` | int64 | Start time (μs) |
-| `end_time_us` | int64 | End time (μs) |
-| `locked_start_us` | int64 | Locked start (μs) |
-| `locked_end_us` | int64 | Locked end (μs) |
-| `user_time_us` | int64 | User timecode (μs) |
+| `packets_received` |  int64 | Total packets received |
+| `packets_received_lost` |  int32 | Packets lost during reception |
+| `packet_ack_sent` |  int32 | ACK packets sent |
+| `packet_nack_sent` |  int32 | NACK packets sent (retransmission requests) |
+| `bytes_received` |  int64 | Total bytes received |
+| `bytes_received_lost` |  int64 | Bytes lost during reception |
+| `receive_rate_mbps` |  double | Current receive rate (Mbps) |
+| `tsbpd_delay` |  int32 | Timestamp-based packet delivery delay (ms) |
+| `bandwidth_mbps` |  double | Available bandwidth (Mbps) |
+| `rtt_ms` |  double | Round-trip time (ms) |
-### PlaylistItem
-| Field | Type | Description |
-|-------|------|-------------|
-| `recorder_id` | string | Recorder ID |
-| `id` | uint64 | Clip ID |
-| `transition_time_us` | int64 | Transition duration (μs) |
-| `transition_type` | TransitionType | Transition type |
-| `transition_fade_color` | Vec4 | Fade color |
-| `speed` | float | Playback speed |
-| `audio_routing` | uint32[] | Audio channel routing |
-| `start_time_us` | int64? | Start time (μs) |
-| `end_time_us` | int64? | End time (μs) |
-| `audio_levels` | float[] | Audio levels per channel (0–1) |
+### SRTSendStatistics
+SRT send statistics.
+Provides detailed metrics for SRT stream transmission.
-### RecorderRequest
 | Field | Type | Description |
 |-------|------|-------------|
-| `recorder_id` | string | Recorder ID |
+| `packets_sent` |  int64 | Total packets sent |
+| `packets_sent_lost` |  int32 | Packets lost during transmission |
+| `packets_sent_dropped` |  int32 | Packets dropped (buffer full, etc.) |
+| `packets_retransmitted` |  int32 | Packets retransmitted |
+| `packet_ack_received` |  int32 | ACK packets received |
+| `packet_nack_received` |  int32 | NACK packets received |
+| `bytes_sent` |  int64 | Total bytes sent |
+| `bytes_sent_dropped` |  int64 | Bytes dropped |
+| `send_rate_mbps` |  double | Current send rate (Mbps) |
+| `bandwidth_mbps` |  double | Available bandwidth (Mbps) |
+| `rtt_ms` |  double | Round-trip time (ms) |
-Oneof `request`:
-| Field | Type |
-|-------|------|
-| `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 |
+### SystemStatus
+System status information.
+Provides overall system health and performance metrics.
-### RecorderEvent
 | Field | Type | Description |
 |-------|------|-------------|
-| `id` | string | Recorder ID |
-| `online` | bool | Is recorder online |
-| `message` | string? | Event message |
+| `uptime` |  uint64 | System uptime in seconds |
+| `framedrops` |  uint32 | Total frames dropped |
+| `framerate` |  float | Current framerate (fps) |
+| `gpu_mem` |  uint64 | GPU memory used (bytes) - deprecated, use gpu_mem_used |
+| `cpu_mem` |  uint64 | CPU memory used (bytes) |
+| `mem_gpu_pool` |  MemoryDomainStats | GPU pool memory stats |
+| `mem_cpu_pool` |  MemoryDomainStats | CPU pool memory stats |
+| `mem_gpu_adhoc` |  MemoryDomainStats | GPU ad-hoc allocation stats |
+| `mem_gpu_pinned` |  MemoryDomainStats | GPU pinned memory stats |
+| `gpu_mem_total` |  uint64 | GPU hardware metrics (via NVML)
+Total GPU memory (bytes) |
+| `gpu_mem_used` |  uint64 | Used GPU memory (bytes) |
+| `gpu_utilization` |  uint32 | SM/compute utilization (0-100%) |
+| `gpu_mem_utilization` |  uint32 | Memory controller utilization (0-100%) |
+| `gpu_encoder_utilization` |  uint32 | NVENC utilization (0-100%) |
+| `gpu_decoder_utilization` |  uint32 | NVDEC utilization (0-100%) |
+| `gpu_name` |  string | GPU model name |
+| `vma_bytes` |  uint64 | Vulkan Memory Allocator total bytes |
 ---
-## Jobs
-`sesame.v1.jobs`
+## sesame/v1/status/status.proto
-### JobType
+`sesame.v1.status`
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `JOB_TYPE_UNSPECIFIED` | Invalid |
-| 1 | `JOB_TYPE_EXPORT` | Playlist export |
-| 2 | `JOB_TYPE_IMPORT` | Clip import |
-### JobStatus
-| Value | Name | Description |
-|-------|------|-------------|
-| 0 | `JOB_STATUS_UNSPECIFIED` | Invalid |
-| 1 | `JOB_STATUS_PENDING` | Queued, not started |
-| 2 | `JOB_STATUS_IN_PROGRESS` | Running (includes progress events) |
-| 3 | `JOB_STATUS_COMPLETE` | Finished successfully |
-| 4 | `JOB_STATUS_ABORTED` | Aborted by user |
-| 5 | `JOB_STATUS_ERROR` | Failed with error |
-### Job
+### IODeviceType
-| Field | Type | Description |
+I/O device type.
+| Value | Name | Description |
 |-------|------|-------------|
-| `id` | uint32 | Job ID |
-| `type` | JobType | Job type |
-| `status` | JobStatus | Current status |
-| `name` | string | Job name |
-| `description` | string | Job description (e.g. filename) |
-| `error` | string? | Error message (when status = ERROR) |
-| `progress` | int64 | Current progress (μs) |
-| `total` | int64 | Total duration (μs) |
-| `timing_info` | TimingInfo? | Timing info (set on import completion) |
+| 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 |
-### JobStartRequest
-Oneof `config`:
+### CompositorStatus
-| Field | Type |
-|-------|------|
-| `export_request` | ExportStartRequest |
-| `import_request` | ImportStartRequest |
+Compositor status.
-### JobAbortRequest
 | Field | Type | Description |
 |-------|------|-------------|
-| `job_id` | uint32 | Job ID to abort |
-### JobStatusRequest
+| `id` |  string | Compositor ID |
-| Field | Type | Description |
-|-------|------|-------------|
-| `job_id` | uint32 | Job ID |
-### JobListRequest
+### ErrorEvent
-Empty message — returns all jobs.
+Error event.
-### ExportConfiguration
 | Field | Type | Description |
 |-------|------|-------------|
-| `filename` | string | Output filename |
-| `container` | ContainerFormat | Container format |
-| `video_codec` | CodecId | Video codec |
-| `width` | uint32 | Width |
-| `height` | uint32 | Height |
-| `fps_num` | uint32 | Frame rate numerator |
-| `fps_den` | uint32 | Frame rate denominator |
-| `rate_control` | RateControlMode | Rate control mode |
-| `video_bitrate_kbps` | uint32 | Video bitrate (kbps) |
-| `max_video_bitrate_kbps` | uint32 | Peak bitrate cap (kbps) |
-| `gop_size` | uint32 | GOP size (frames) |
-| `max_b_frames` | uint32 | Max B-frames |
-| `profile` | string | Codec profile (e.g. main, high) |
-| `level` | string | Codec level (e.g. 4.1) |
-| `pixel_format` | string | Pixel format (e.g. yuv420p) |
-| `color_primaries` | string | Color primaries (e.g. bt709) |
-| `color_transfer` | string | Transfer characteristics |
-| `color_matrix` | string | Matrix coefficients |
-| `full_range` | bool | Full range vs limited |
-| `audio_codec` | AudioCodecId | Audio codec |
-| `audio_bitrate_kbps` | uint32 | Audio bitrate (kbps) |
-| `audio_sample_rate_hz` | uint32 | Audio sample rate (Hz) |
-| `audio_channels` | uint32 | Audio channels |
-| `audio_routing` | uint32[] | Audio channel routing |
+| `msg` |  string | Error message |
-### ContainerFormat
-| Value | Name |
-|-------|------|
-| 0 | `CONTAINER_FORMAT_UNSPECIFIED` |
-| 1 | `CONTAINER_FORMAT_MP4` |
-| 2 | `CONTAINER_FORMAT_MOV` |
-| 3 | `CONTAINER_FORMAT_MKV` |
-| 4 | `CONTAINER_FORMAT_MXF` |
+### Event
-### AudioCodecId
+Event message wrapper.
-| Value | Name |
-|-------|------|
-| 0 | `AUDIO_CODEC_ID_UNSPECIFIED` |
-| 1 | `AUDIO_CODEC_ID_AAC` |
-| 2 | `AUDIO_CODEC_ID_OPUS` |
-| 3 | `AUDIO_CODEC_ID_PCM_S16LE` |
-| 4 | `AUDIO_CODEC_ID_PCM_S24LE` |
-### RateControlMode
+| Field | Type | Description |
+|-------|------|-------------|
+| `error_event` |  ErrorEvent | Error event |
+| `transport_event` |  TransportEvent | Transport event |
+| `callback_event` |  sesame.v1.common.Callback | Callback event |
+| `job_event` |  sesame.v1.jobs.Job | Job event (per-job state change) |
+| `recorder_event` |  sesame.v1.recorder.RecorderEvent | Recorder event |
-| Value | Name |
-|-------|------|
-| 0 | `RATE_CONTROL_MODE_UNSPECIFIED` |
-| 1 | `RATE_CONTROL_MODE_CBR` |
-| 2 | `RATE_CONTROL_MODE_VBR` |
-| 3 | `RATE_CONTROL_MODE_CQ` |
-### ImportConfiguration
+### IODeviceItem
+I/O device item.
 | Field | Type | Description |
 |-------|------|-------------|
-| `src_filename` | string | Source filename |
-| `audio_routing` | uint32[] | Audio channel routing |
-| `dst_recorder_id` | string | Destination recorder ID |
-| `dst_clip_id` | uint64 | Destination clip ID |
-| `dst_clip_name` | string | Destination clip name |
-| `dst_clip_user_data` | string | Destination clip user data |
----
+| `id` |  string | Device ID |
+| `name` |  string | Device name |
+| `type` |  IODeviceType | Device type |
-## Status & Events
-`sesame.v1.status`
+### IODeviceListResponse
-### Status
+I/O device list response.
-Full system status returned by `RequestStatus`.
 | Field | Type | Description |
 |-------|------|-------------|
-| `system_status` | SystemStatus | System stats |
-| `render_status_gpu` | FrameTiming | GPU render timing |
-| `render_status_cpu` | FrameTiming | CPU render timing |
-| `sources` | SourceStatus[] | All source status |
-| `compositions` | CompositorStatus[] | All compositor status |
-| `audio_mixes` | AudioMixerStatus[] | All audio mixer status |
-| `outputs` | OutputStatus[] | All output status |
-| `recorders` | RecorderStatus[] | All recorder status |
+| `devices` | repeated IODeviceItem | List of devices |
-### Event
-Push event wrapper. Oneof `event`:
+### Status
-| Field | Type | Topic |
-|-------|------|-------|
-| `error_event` | ErrorEvent | `EVENT_TOPIC_ERROR` |
-| `transport_event` | TransportEvent | `EVENT_TOPIC_TRANSPORT` |
-| `callback_event` | Callback | `EVENT_TOPIC_CALLBACK` |
-| `job_event` | Job | `EVENT_TOPIC_JOB` |
-| `recorder_event` | RecorderEvent | `EVENT_TOPIC_RECORDER` |
+Overall system status.
-### TransportEvent
 | Field | Type | Description |
 |-------|------|-------------|
-| `source_id` | string | Source ID |
-| `user_id` | string | User ID |
-| `uri` | string | Source URI |
-| `state` | SourceTransportState | Transport state |
-| `duration_us` | int64 | Duration (μs) |
-| `position_us` | int64 | Playback position (μs) |
-| `material_position_us` | int64 | Material position (μs) |
-| `user_time_us` | int64 | User time (μs) |
-| `speed` | float | Playback speed |
-| `user_playlist_id` | string | User playlist ID |
-| `playlist_index` | uint32 | Playlist item index |
-| `playlist_length` | uint32 | Playlist length |
-| `clip_id` | uint64 | Clip ID |
-| `clip_position_us` | int64 | Position within clip (μs) |
-| `clip_duration_us` | int64 | Clip duration (μs) |
-| `preroll` | uint32 | Pre-roll frames |
-| `postroll` | uint32 | Post-roll frames |
-| `metadata` | string | Transport metadata |
+| `system_status` |  SystemStatus | System status |
+| `render_status_gpu` |  FrameTiming | GPU render timing |
+| `render_status_cpu` |  FrameTiming | CPU render timing |
+| `sources` | repeated sesame.v1.sources.SourceStatus | Source status |
+| `compositions` | repeated CompositorStatus | Compositor status |
+| `audio_mixes` | repeated sesame.v1.audio.AudioMixerStatus | Audio mixer status |
+| `outputs` | repeated sesame.v1.outputs.OutputStatus | Output status |
+| `recorders` | repeated sesame.v1.recorder.RecorderStatus | Recorder status |
 ### SubscriptionRequest
+Subscription request.
 | Field | Type | Description |
 |-------|------|-------------|
-| `event_topics` | EventTopic[] | Topics to subscribe to |
-| `channels` | string[] | Dynamic channels (e.g. `media-stream/<id>`) |
+| `event_topics` | repeated sesame.v1.common.EventTopic | Typed event topics to subscribe to |
+| `channels` | repeated string | Dynamic channel subscriptions (e.g. video/audio channels) |
+### TransportEvent
+Transport event (source playback state change).
-### IODeviceItem
 | Field | Type | Description |
 |-------|------|-------------|
-| `id` | string | Device ID |
-| `name` | string | Device name |
-| `type` | IODeviceType | Device type |
-### IODeviceType
+| `source_id` |  string | Source ID |
+| `user_id` |  string | User ID |
+| `uri` |  string | Source URI |
+| `state` |  sesame.v1.sources.SourceTransportState | Transport state |
+| `duration_us` |  int64 | Duration (us) |
+| `position_us` |  int64 | Playback position (us) |
+| `material_position_us` |  int64 | Material position (us) |
+| `user_time_us` |  int64 | User time (us) |
+| `speed` |  float | Playback speed |
+| `user_playlist_id` |  string | User playlist ID |
+| `playlist_index` |  uint32 | Playlist item index |
+| `playlist_length` |  uint32 | Playlist length |
+| `clip_id` |  uint64 | Clip ID (if playing from recorder) |
+| `clip_position_us` |  int64 | Position within clip (us) |
+| `clip_duration_us` |  int64 | Duration of clip (us) |
+| `preroll` |  uint32 |  |
+| `postroll` |  uint32 |  |
+| `metadata` |  sesame.v1.common.TransportMetadata | Transport metadata |
-| Value | Name |
-|-------|------|
-| 0 | `IO_DEVICE_TYPE_UNSPECIFIED` |
-| 1 | `IO_DEVICE_TYPE_VIDEO_INPUT` |
-| 2 | `IO_DEVICE_TYPE_VIDEO_OUTPUT` |
-| 3 | `IO_DEVICE_TYPE_AUDIO_INPUT` |
-| 4 | `IO_DEVICE_TYPE_AUDIO_OUTPUT` |
 ---
-## Statistics
-`sesame.v1.status`
+## sesame/v1/wire/wire.proto
-### FrameTiming
+`sesame.v1.wire`
-| Field | Type | Description |
-|-------|------|-------------|
-| `frame_time` | int32 | Current frame time (μs) |
-| `frame_time_avg` | int32 | Average frame time (μs) |
-| `frame_time_min` | int32 | Minimum frame time (μs) |
-| `frame_time_max` | int32 | Maximum frame time (μs) |
-### SystemStatus
-| Field | Type | Description |
-|-------|------|-------------|
-| `uptime` | uint64 | Uptime (seconds) |
-| `framedrops` | uint32 | Total frames dropped |
-| `framerate` | float | Current framerate |
-| `gpu_mem` | uint64 | GPU memory used (deprecated) |
-| `cpu_mem` | uint64 | CPU memory used (bytes) |
-| `mem_gpu_pool` | MemoryDomainStats | GPU pool memory |
-| `mem_cpu_pool` | MemoryDomainStats | CPU pool memory |
-| `mem_gpu_adhoc` | MemoryDomainStats | GPU ad-hoc allocations |
-| `mem_gpu_pinned` | MemoryDomainStats | GPU pinned memory |
-| `gpu_mem_total` | uint64 | Total GPU memory (bytes) |
-| `gpu_mem_used` | uint64 | Used GPU memory (bytes) |
-| `gpu_utilization` | uint32 | SM compute utilization (0–100) |
-| `gpu_mem_utilization` | uint32 | Memory controller (0–100) |
-| `gpu_encoder_utilization` | uint32 | NVENC utilization (0–100) |
-| `gpu_decoder_utilization` | uint32 | NVDEC utilization (0–100) |
-| `gpu_name` | string | GPU model name |
-| `vma_bytes` | uint64 | Vulkan Memory Allocator bytes |
-### MemoryDomainStats
+### FrameType
-| Field | Type | Description |
+Type of frame carried on the wire.
+| Value | Name | Description |
 |-------|------|-------------|
-| `current_bytes` | uint64 | Current allocated |
-| `peak_bytes` | uint64 | Peak allocated |
-| `budget_bytes` | uint64 | Budget limit |
+| 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` |  |
-### SRTReceiveStatistics
-| Field | Type | Description |
-|-------|------|-------------|
-| `packets_received` | int64 | Total packets received |
-| `packets_received_lost` | int32 | Packets lost |
-| `packet_ack_sent` | int32 | ACK packets sent |
-| `packet_nack_sent` | int32 | NACK packets sent |
-| `bytes_received` | int64 | Total bytes received |
-| `bytes_received_lost` | int64 | Bytes lost |
-| `receive_rate_mbps` | double | Receive rate (Mbps) |
-| `tsbpd_delay` | int32 | TSBPD delay (ms) |
-| `bandwidth_mbps` | double | Available bandwidth (Mbps) |
-| `rtt_ms` | double | Round-trip time (ms) |
+### FrameHeader
+Header for every websocket / MoQ frame.
+Serialized with a 4-byte little-endian size prefix on the wire.
-### SRTSendStatistics
 | Field | Type | Description |
 |-------|------|-------------|
-| `packets_sent` | int64 | Total packets sent |
-| `packets_sent_lost` | int32 | Packets lost |
-| `packets_sent_dropped` | int32 | Packets dropped |
-| `packets_retransmitted` | int32 | Packets retransmitted |
-| `packet_ack_received` | int32 | ACK packets received |
-| `packet_nack_received` | int32 | NACK packets received |
-| `bytes_sent` | int64 | Total bytes sent |
-| `bytes_sent_dropped` | int64 | Bytes dropped |
-| `send_rate_mbps` | double | Send rate (Mbps) |
-| `bandwidth_mbps` | double | Available bandwidth (Mbps) |
-| `rtt_ms` | double | Round-trip time (ms) |
+| `type` |  FrameType |  |
+| `routing_metadata` |  string | Source routing (inbound only) |
+| `media` |  MediaFrameData | Present for VIDEO, AUDIO, MUXED, DECODER_DATA |
----
-## Service Methods
+### MediaCodecData
-`sesame.v1.rpc.SesameAPIService`
+Codec parameters for a media stream.
-| Method | Request | Response | Description |
-|--------|---------|----------|-------------|
-| `ExecuteCommandList` | CommandList | CommandExecutionResponse | Execute batched commands |
-| `UpdateSubscriptions` | SubscriptionRequest | Empty | Update event subscriptions |
-| `RequestStatus` | Empty | Status | Get full system status |
-| `RequestEvents` | Empty | stream Event | Subscribe to events (server streaming) |
-| `StartJob` | JobStartRequest | Job | Start export/import job |
-| `AbortJob` | JobAbortRequest | Job | Abort a running job |
-| `GetJobStatus` | JobStatusRequest | Job | Get job status by ID |
-| `ListJobs` | JobListRequest | JobList | List all jobs |
-| `RequestRecorderOperation` | RecorderRequest | RecorderResponse | Recorder operations |
-| `RequestKeyframe` | KeyframeRequest | Empty | Request keyframe from encoder |
-| `RequestIODeviceList` | Empty | IODeviceListResponse | List I/O devices |
----
+| 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 |  |
-## Event Subscriptions
-Clients must subscribe to receive push events. Call `UpdateSubscriptions` with desired `EventTopic` values:
+### MediaFrameData
-```typescript
-client.addSubscription(sesame.v1.common.EventTopic.EVENT_TOPIC_TRANSPORT, callback);
-client.addSubscription(sesame.v1.common.EventTopic.EVENT_TOPIC_JOB, callback);
-```
+Media-specific fields for VIDEO, AUDIO, MUXED, and DECODER_DATA frames.
+| Field | Type | Description |
+|-------|------|-------------|
+| `pts` |  uint64 | Presentation timestamp in codec_data timebase units |
+| `keyframe` |  bool | True for video key frames |
+| `codec_data` |  MediaCodecData | Codec parameters (may be present on first frame or key frames) |
-| 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 |
 ---
 ## Scene Graph Properties
 Properties are set via `PropertySetRequest` or animated via `PropertyAnimateRequest`. The `domain` field identifies the owning engine object.
@@ -1108,19 +2061,19 @@ Properties are set via `PropertySetRequest` or animated via `PropertyAnimateRequ
 | Property | Type | Description |
 |----------|------|-------------|
+| `position` | vec4 | XYZ position |
 | `position.x` | float | X position |
 | `position.y` | float | Y position |
-| `position.z` | float | Z position |
-| `position` | vec4 | XYZ 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 |
-| `scale` | vec4 | XYZ scale |
-| `rotation.x` | float | X rotation |
-| `rotation.y` | float | Y rotation |
-| `rotation.z` | float | Z rotation |
-| `rotation` | vec4 | XYZ rotation |
-| `opacity` | float | Opacity (0–1) |
+| `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 |
@@ -1129,7 +2082,7 @@ Properties are set via `PropertySetRequest` or animated via `PropertyAnimateRequ
 | Property | Type | Description |
 |----------|------|-------------|
-| `size` | vec4 | Width/height |
+| `size` | vec4 | Width and height |
 | `size.x` | float | Width |
 | `size.y` | float | Height |
 | `origin` | vec4 | Origin point |
@@ -1173,14 +2126,22 @@ Properties are set via `PropertySetRequest` or animated via `PropertyAnimateRequ
 #### Effects
-**All effects:** `enabled` (bool)
+**All effects:**
+| Property | Type | Description |
+|----------|------|-------------|
+| `enabled` | bool | Enable/disable the effect |
-**RTT Effect:** `rtt-id` (string)
+**RTT Effect:**
+| Property | Type | Description |
+|----------|------|-------------|
+| `rtt-id` | string | Render-to-texture target ID |
 **Timecode Effect:**
-| Property | Type | Values |
-|----------|------|--------|
+| 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 |
@@ -1189,10 +2150,10 @@ Properties are set via `PropertySetRequest` or animated via `PropertyAnimateRequ
 | Property | Type | Description |
 |----------|------|-------------|
 | `clip-plane` | vec4 | Clip plane XYZW |
-| `clip-plane.r` / `.x` | float | Clip plane X |
-| `clip-plane.g` / `.y` | float | Clip plane Y |
-| `clip-plane.b` / `.z` | float | Clip plane Z |
-| `clip-plane.a` / `.w` | float | Clip plane W |
+| `clip-plane.r / clip-plane.x` | float | Clip plane X |
+| `clip-plane.g / clip-plane.y` | float | Clip plane Y |
+| `clip-plane.b / clip-plane.z` | float | Clip plane Z |
+| `clip-plane.a / clip-plane.w` | float | Clip plane W |
 | `feather` | float | Feather amount |
 ### Audio Mixer Domain (`domain.audio_mixer_id`)
@@ -1201,8 +2162,8 @@ Address format: `channel_id` for channel properties, `channel_id/plugin_id` for
 | Property | Type | Description |
 |----------|------|-------------|
-| `level` | float | Channel level (0–1) |
-| `pan` | float | Pan position (−1 to 1) |
+| `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 |
@@ -1216,3 +2177,26 @@ Address format: `processor_id` for preprocessor parameters.
 |----------|------|-------------|
 | `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 |