npm - @stinkycomputing/sesame-api-client - Versions diffs - 1.4.1-beta.8 → 1.4.2-alpha.1 - Mend

@stinkycomputing/sesame-api-client 1.4.1-beta.8 → 1.4.2-alpha.1

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

package/dist/command-list.d.ts +26 -2
package/dist/command-list.d.ts.map +1 -1
package/dist/generated/property-types.d.ts +845 -0
package/dist/generated/property-types.d.ts.map +1 -0
package/dist/index.browser.mjs +3746 -2108
package/dist/index.browser.mjs.map +2 -2
package/dist/index.cjs +3746 -2108
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 +3746 -2108
package/dist/index.mjs.map +2 -2
package/dist/proto/api.d.ts +917 -86
package/dist/proto/api.js +10347 -7739
package/dist/sesame-wire-protocol.d.ts +1 -1
package/dist/sesame-wire-protocol.d.ts.map +1 -1
package/docs/protocol-reference.md +1747 -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 |   |
+| `channel_config` |  AudioMixerChannel |   |
+### AudioChannelPluginStatus
+Audio channel plugin status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `type` |  string |   |
+| `params` | repeated AudioPluginParamStatus |   |
+### AudioChannelRemoveRequest
+Request to remove a channel from an audio mixer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `mixer_id` |  string |   |
+| `channel_id` |  string |   |
+### AudioChannelStatus
+Audio channel status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `output_type` |  AudioMixerChannelType |   |
+| `level` |  float |   |
+| `pan` |  float |   |
+| `vu` | repeated float |   |
+| `has_data` |  bool |   |
+| `read_errors` |  uint32 |   |
+| `plugins` | repeated AudioChannelPluginStatus |   |
+### AudioMixerAddRequest
+Request to add a new audio mixer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `config` |  AudioMixerConfig |   |
+### AudioMixerChannel
+Audio mixer channel configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `source_id` |  string |   |
+| `channel_type` |  AudioMixerChannelType |   |
+| `source_channels` | repeated uint32 |   |
+| `level` |  float |   |
+| `pan` |  float |   |
+| `plugins` | repeated AudioPlugin |   |
+### AudioMixerConfig
+Audio mixer configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `channels` | repeated AudioMixerChannel |   |
+| `output_type` |  AudioMixerChannelType |   |
+| `order` |  uint32 |   |
+### AudioMixerRemoveRequest
+Request to remove an audio mixer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+### AudioMixerStatus
+Audio mixer status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `output_type` |  AudioMixerChannelType |   |
+| `vu` | repeated float |   |
+| `channels` | repeated AudioChannelStatus |   |
+### AudioMixerUpdateRequest
+Request to update an existing audio mixer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `config` |  AudioMixerConfig |   |
+### AudioPlugin
+Audio plugin instance.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `type` |  string |   |
+| `params` | repeated AudioPluginParam |   |
+| `aux_input_mix_ids` | repeated string |   |
+### AudioPluginParam
+Audio plugin parameter.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  uint32 |   |
+| `float_value` |  float |   |
+### AudioPluginParamStatus
+Audio plugin parameter status (with display info).
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  uint32 |   |
+| `float_value` |  float |   |
+| `label` |  string |   |
+| `display_value` |  string |   |
+---
+## sesame/v1/commands/commands.proto
+`sesame.v1.commands`
+### CommandExecutionResponse
+Command execution response.
+Reserved for future per-command results.
+### CommandList
+Command list.
+A list of commands to execute in sequence.
+| Field | Type | Description |
+|-------|------|-------------|
+| `command_list` | repeated CommandListItem |   |
+### CommandListItem
+Command list item.
+Each item represents a single command to execute at a specific time offset.
-### 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 |   |
+| `add_source` |  sesame.v1.sources.SourceAddRequest |   |
+| `update_source` |  sesame.v1.sources.SourceUpdateRequest |   |
+| `remove_source` |  sesame.v1.sources.SourceRemoveRequest |   |
+| `add_output` |  sesame.v1.outputs.OutputAddRequest |   |
+| `update_output` |  sesame.v1.outputs.OutputUpdateRequest |   |
+| `remove_output` |  sesame.v1.outputs.OutputRemoveRequest |   |
+| `add_compositor` |  sesame.v1.compositor.CompositorAddRequest |   |
+| `remove_compositor` |  sesame.v1.compositor.CompositorRemoveRequest |   |
+| `clear_compositor` |  sesame.v1.compositor.CompositorClearRequest |   |
+| `add_node` |  sesame.v1.compositor.NodeAddRequest |   |
+| `remove_node` |  sesame.v1.compositor.NodeRemoveRequest |   |
+| `set_property` |  sesame.v1.compositor.PropertySetRequest |   |
+| `animate_property` |  sesame.v1.compositor.PropertyAnimateRequest |   |
+| `add_audio_mixer` |  sesame.v1.audio.AudioMixerAddRequest |   |
+| `update_audio_mixer` |  sesame.v1.audio.AudioMixerUpdateRequest |   |
+| `remove_audio_mixer` |  sesame.v1.audio.AudioMixerRemoveRequest |   |
+| `add_audio_channel` |  sesame.v1.audio.AudioChannelAddRequest |   |
+| `remove_audio_channel` |  sesame.v1.audio.AudioChannelRemoveRequest |   |
+| `update_source_transport` |  sesame.v1.sources.SourceTransportCommand |   |
+| `load_playlist` |  sesame.v1.sources.LoadPlaylistRequest |   |
+| `eject_playlist` |  sesame.v1.sources.EjectPlaylistRequest |   |
+| `callback` |  sesame.v1.common.Callback |   |
+| `set_source_metadata` |  sesame.v1.sources.SourceMetadataSetRequest |   |
+| `transaction_id` | optional uint32 |   |
+| `transaction_deps` | repeated uint32 |   |
 ---
-## 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 |   |
+| `data` |  string |   |
+### Empty
+Empty message for RPCs that don't need request/response data.
+This is the standard protobuf convention for "void" operations.
+### NameValue
+Key-value pair for metadata and generic data.
+Used for transport metadata, custom properties, etc.
-### Vec4
 | Field | Type | Description |
 |-------|------|-------------|
-| `x` | float | Red / X |
-| `y` | float | Green / Y |
-| `z` | float | Blue / Z |
-| `w` | float | Alpha / W |
+| `name` |  string |   |
+| `value` |  PropValue |   |
 ### 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 |   |
+| `vec4_value` |  Vec4 |   |
+| `string_value` |  string |   |
+| `bool_value` |  bool |   |
+| `int_value` |  int32 |   |
 ### 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 |   |
+| `audio_mixer_id` |  string |   |
+| `replay_id` |  string |   |
+| `source_id` |  string |   |
+### TransportMetadata
+Transport metadata (timecode, etc.).
+Used for source and recorder metadata operations.
+| Field | Type | Description |
+|-------|------|-------------|
+| `items` | repeated NameValue |   |
+### Vec4
+4-component vector used for colors (RGBA), positions, rectangles, etc.
+Components are typically in the range [0.0, 1.0] for colors,
+but can be arbitrary for positions and sizes.
-### Callback
 | Field | Type | Description |
 |-------|------|-------------|
-| `event` | string | Event name identifier |
-| `data` | string | Event data (JSON or other) |
+| `x` |  float |   |
+| `y` |  float |   |
+| `z` |  float |   |
+| `w` |  float |   |
 ---
-## 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 |   |
+| `multisample` |  bool |   |
+| `width` |  uint32 |   |
+| `height` |  uint32 |   |
+### 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 |   |
----
-## 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 |   |
+### 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 |   |
+| `value` |  sesame.v1.common.PropValue |   |
+| `easing_in` |  string |   |
+| `easing_out` |  string |   |
----
-## 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 |   |
+| `parent_address` |  string |   |
+| `node_id` |  string |   |
+| `node_type` |  NodeType |   |
-### 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 |   |
+| `address` |  string |   |
-### 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 |   |
+| `address` |  string |   |
+| `property` |  string |   |
+| `keyframes` | repeated KeyFrame |   |
+| `before` |  AnimationChannelEvaluationMode |   |
+| `after` |  AnimationChannelEvaluationMode |   |
+### PropertySetRequest
+Request to set a property value.
+| Field | Type | Description |
+|-------|------|-------------|
+| `domain` |  sesame.v1.common.PropertyDomain |   |
+| `address` |  string |   |
+| `property` |  string |   |
+| `value` |  sesame.v1.common.PropValue |   |
+---
+## sesame/v1/jobs/jobs.proto
+`sesame.v1.jobs`
+### ContainerFormat
+Container format for exported files.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `CONTAINER_FORMAT_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `CONTAINER_FORMAT_MP4` | MP4 container |
+| 2 | `CONTAINER_FORMAT_MOV` | QuickTime MOV container |
+| 3 | `CONTAINER_FORMAT_MKV` | Matroska container |
+| 4 | `CONTAINER_FORMAT_MXF` | Material eXchange Format |
+### JobStatus
+Job status.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `JOB_STATUS_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `JOB_STATUS_PENDING` | Pending (not started) |
+| 2 | `JOB_STATUS_IN_PROGRESS` | In progress |
+| 3 | `JOB_STATUS_COMPLETE` | Complete |
+| 4 | `JOB_STATUS_ABORTED` | Aborted by user |
+| 5 | `JOB_STATUS_ERROR` | Error occurred |
+### JobType
+Job type.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `JOB_TYPE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `JOB_TYPE_EXPORT` | Playlist export |
+| 2 | `JOB_TYPE_IMPORT` | Clip import |
+### RateControlMode
+Rate control mode for video encoding.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `RATE_CONTROL_MODE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `RATE_CONTROL_MODE_CBR` | Constant bitrate |
+| 2 | `RATE_CONTROL_MODE_VBR` | Variable bitrate |
+| 3 | `RATE_CONTROL_MODE_CQ` | Constant quality |
+### ExportConfiguration
+Playlist export configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `filename` |  string |   |
+| `container` |  ContainerFormat |   |
+| `video_codec` |  sesame.v1.common.CodecType |   |
+| `width` |  uint32 |   |
+| `height` |  uint32 |   |
+| `fps_num` |  uint32 |   |
+| `fps_den` |  uint32 |   |
+| `rate_control` |  RateControlMode |   |
+| `video_bitrate_kbps` |  uint32 |   |
+| `max_video_bitrate_kbps` |  uint32 |   |
+| `gop_size` |  uint32 |   |
+| `max_b_frames` |  uint32 |   |
+| `profile` |  string |   |
+| `level` |  string |   |
+| `pixel_format` |  string |   |
+| `color_primaries` |  string |   |
+| `color_transfer` |  string |   |
+| `color_matrix` |  string |   |
+| `full_range` |  bool |   |
+| `audio_codec` |  sesame.v1.common.CodecType |   |
+| `audio_bitrate_kbps` |  uint32 |   |
+| `audio_sample_rate_hz` |  uint32 |   |
+| `audio_channels` |  uint32 |   |
+| `audio_routing` | repeated uint32 |   |
+### ExportStartRequest
+Request to start playlist export.
+| Field | Type | Description |
+|-------|------|-------------|
+| `config` |  ExportConfiguration |   |
+| `items` | repeated sesame.v1.recorder.PlaylistItem |   |
+### ImportConfiguration
+Clip import configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `src_filename` |  string |   |
+| `audio_routing` | repeated uint32 |   |
+| `dst_recorder_id` |  string |   |
+| `dst_clip_id` |  uint64 |   |
+| `dst_clip_name` |  string |   |
+| `dst_clip_user_data` |  string |   |
+### ImportStartRequest
+Request to start clip import.
+| Field | Type | Description |
+|-------|------|-------------|
+| `config` |  ImportConfiguration |   |
+### Job
+A job. Used as RPC response, list item, and event payload.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  uint32 |   |
+| `type` |  JobType |   |
+| `status` |  JobStatus |   |
+| `name` |  string |   |
+| `description` |  string |   |
+| `error` | optional string |   |
+| `progress` |  int64 |   |
+| `total` |  int64 |   |
+| `timing_info` | optional TimingInfo |   |
+### JobAbortRequest
+Request to abort a job.
+| Field | Type | Description |
+|-------|------|-------------|
+| `job_id` |  uint32 |   |
+### JobList
+List of jobs.
+| Field | Type | Description |
+|-------|------|-------------|
+| `jobs` | repeated Job |   |
+### JobListRequest
+Request to list all jobs.
+### JobStartRequest
+Request to start a job.
+| Field | Type | Description |
+|-------|------|-------------|
+| `export_request` |  ExportStartRequest |   |
+| `import_request` |  ImportStartRequest |   |
+### JobStatusRequest
+Request to get job status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `job_id` |  uint32 |   |
+### TimingInfo
+Timing information for clips.
+| Field | Type | Description |
+|-------|------|-------------|
+| `tc_in` |  int64 |   |
+| `tc_out` |  int64 |   |
+---
+## sesame/v1/outputs/output.proto
+`sesame.v1.outputs`
+### EncoderPreset
+Encoder preset.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `ENCODER_PRESET_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `ENCODER_PRESET_LOW_LATENCY` | Low-latency tune |
+| 2 | `ENCODER_PRESET_LOW_LATENCY_IDR_ONLY` | Low-latency with IDR-only GOP |
+| 3 | `ENCODER_PRESET_HIGH_QUALITY` | High-quality tune |
+### OutputType
+Type of output.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `OUTPUT_TYPE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `OUTPUT_TYPE_ENCODED_WEBSOCKET` | Encoded WebSocket stream |
+| 2 | `OUTPUT_TYPE_ENCODED_RECORDER` | Encoded recorder |
+| 3 | `OUTPUT_TYPE_DECKLINK` | Blackmagic Decklink output |
+| 4 | `OUTPUT_TYPE_SYSTEM_AUDIO` | System audio output |
+| 5 | `OUTPUT_TYPE_ENCODED_SRT` | Encoded SRT stream |
+| 6 | `OUTPUT_TYPE_ENCODED_MOQ` | Encoded MoQ stream |
+| 7 | `OUTPUT_TYPE_ENCODED_SUPER_SLOWMO_RECORDER` | Super slow-mo recorder |
+### RecorderType
+Recorder type.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `RECORDER_TYPE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `RECORDER_TYPE_LIVE` | Live recorder (circular buffer) |
+| 2 | `RECORDER_TYPE_CLIPS` | Clip recorder; not continuously recording, only ingested frames are persisted |
+### DecklinkOutputConfig
+Decklink output configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `device_index` |  uint32 |   |
+| `video_format` |  sesame.v1.common.VideoFormat |   |
+| `key_and_fill` |  bool |   |
+### EncodedMoqOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `encoder` |  EncoderConfig |   |
+| `url` |  string |   |
+| `broadcast` |  string |   |
+| `key` |  string |   |
+### EncodedRecorderOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `encoder` |  EncoderConfig |   |
+| `filename` |  string |   |
+| `size_gb` |  uint32 |   |
+| `group_id` |  string |   |
+| `recorder_type` |  RecorderType |   |
+### EncodedSrtOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `url` |  string |   |
+| `encoder` |  EncoderConfig |   |
+### EncodedSuperSlowMoRecorderOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `encoder` |  EncoderConfig |   |
+| `filename` |  string |   |
+| `size_gb` |  uint32 |   |
+| `group_id` |  string |   |
+| `recorder_type` |  RecorderType |   |
+| `composition_ids` | repeated string |   |
+| `source_ids` | repeated string |   |
+### EncodedWebSocketOutputConfig
+-----------------------------------------------------------------------------
+Type-specific output payloads
+-----------------------------------------------------------------------------
+| Field | Type | Description |
+|-------|------|-------------|
+| `channel` |  string |   |
+| `encoder` |  EncoderConfig |   |
+### EncoderConfig
+Encoded output configuration (WebSocket, SRT, MoQ).
+| Field | Type | Description |
+|-------|------|-------------|
+| `codec` |  sesame.v1.common.CodecType |   |
+| `preset` |  EncoderPreset |   |
+| `bitrate_kbps` |  uint32 |   |
+| `keyframe_interval` |  uint32 |   |
+| `width` |  uint32 |   |
+| `height` |  uint32 |   |
+| `fps` |  float |   |
+### KeyframeRequest
+Keyframe request for encoder.
+Requests an immediate keyframe (IDR frame) from an encoder output.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+### OutputAddRequest
+Request to add a new output.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `composition_id` |  string |   |
+| `audio_mix_ids` | repeated string |   |
+| `use_as_clock` |  bool |   |
+| `websocket` |  EncodedWebSocketOutputConfig |   |
+| `recorder` |  EncodedRecorderOutputConfig |   |
+| `super_slowmo_recorder` |  EncodedSuperSlowMoRecorderOutputConfig |   |
+| `srt` |  EncodedSrtOutputConfig |   |
+| `moq` |  EncodedMoqOutputConfig |   |
+| `decklink` |  DecklinkOutputConfig |   |
+| `system_audio` |  SystemAudioOutputConfig |   |
+### OutputRemoveRequest
+Request to remove an output.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+### OutputStatus
+Output status information.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `type` |  OutputType |   |
+| `state` |  sesame.v1.common.ConnectionState |   |
+| `msg` | optional string |   |
+| `url` |  string |   |
+| `buffer_size` |  uint32 |   |
+| `srt_stats` | optional sesame.v1.status.SRTSendStatistics |   |
+### OutputUpdateRequest
+Request to update an existing output.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `composition_id` |  string |   |
+| `audio_mix_ids` | repeated string |   |
+| `use_as_clock` |  bool |   |
+| `websocket` |  EncodedWebSocketOutputConfig |   |
+| `recorder` |  EncodedRecorderOutputConfig |   |
+| `super_slowmo_recorder` |  EncodedSuperSlowMoRecorderOutputConfig |   |
+| `srt` |  EncodedSrtOutputConfig |   |
+| `moq` |  EncodedMoqOutputConfig |   |
+| `decklink` |  DecklinkOutputConfig |   |
+| `system_audio` |  SystemAudioOutputConfig |   |
+### SystemAudioOutputConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `device_name` |  string |   |
+---
+## sesame/v1/recorder/recorder.proto
+`sesame.v1.recorder`
+### TransitionType
+Transition type for playlist items.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `TRANSITION_TYPE_MIX` | Mix/dissolve transition |
+| 1 | `TRANSITION_TYPE_FADE_TO_COLOR` | Fade to color |
+| 2 | `TRANSITION_TYPE_FADE_FROM_COLOR` | Fade from color |
+| 3 | `TRANSITION_TYPE_FADE_TO_FROM_COLOR` | Fade to and from color |
+### PlaylistItem
+Playlist item for recorder source playback.
+| Field | Type | Description |
+|-------|------|-------------|
+| `recorder_id` |  string |   |
+| `id` |  uint64 |   |
+| `transition_time_us` |  int64 |   |
+| `transition_type` |  TransitionType |   |
+| `transition_fade_color` |  sesame.v1.common.Vec4 |   |
+| `speed` |  float |   |
+| `audio_routing` | repeated uint32 |   |
+| `start_time_us` | optional int64 |   |
+| `end_time_us` | optional int64 |   |
+| `audio_levels` | repeated float |   |
+### RecorderClip
+Recorder clip information.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  uint64 |   |
+| `name` |  string |   |
+| `user_data` |  string |   |
+| `flags` |  uint64 |   |
+| `start_time_us` |  int64 |   |
+| `end_time_us` |  int64 |   |
+| `locked_start_us` |  int64 |   |
+| `locked_end_us` |  int64 |   |
+| `user_time_us` |  int64 |   |
+### RecorderClipAddRequest
+Request to add a clip to a recorder.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clip` |  RecorderClip |   |
+### RecorderClipCopyRequest
+Request to copy a clip.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clip_id` |  uint64 |   |
+| `new_clip_id` |  uint64 |   |
+### RecorderClipFlagSetRequest
+Request to set a clip flag.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clip_id` |  uint64 |   |
+| `flag` |  uint64 |   |
+| `value` |  bool |   |
+### RecorderClipRange
+Clip id range.
+| Field | Type | Description |
+|-------|------|-------------|
+| `low` |  uint64 |   |
+| `high` |  uint64 |   |
+### RecorderClipRemoveRequest
+Request to remove a clip.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clip_id` |  uint64 |   |
+### RecorderClipsClearRequest
+Request to clear clips with filters.
+| Field | Type | Description |
+|-------|------|-------------|
+| `protected_ranges` | repeated RecorderClipRange |   |
+| `must_have_flags` |  uint64 |   |
+| `must_not_have_flags` |  uint64 |   |
+### RecorderClipsGetRequest
+Request to get all clips from a recorder.
+Empty - returns all clips
+### RecorderClipsGetResponse
+Response with recorder clips.
+| Field | Type | Description |
+|-------|------|-------------|
+| `clips` | repeated RecorderClip |   |
+### RecorderClipsVerifyRequest
+Request to verify clip integrity.
+Empty - verifies all clips
+### RecorderClipsVerifyResponse
+Response with verification errors.
+| Field | Type | Description |
+|-------|------|-------------|
+| `errors` | repeated string |   |
+### RecorderEvent
+Recorder event notification.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+| `online` |  bool |   |
+| `message` | optional string |   |
+### RecorderLockedDurationSetRequest
+Request to set locked duration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `frames` |  uint32 |   |
+### RecorderMetadataSetRequest
+Request to set recorder metadata.
+| Field | Type | Description |
+|-------|------|-------------|
+| `metadata` |  sesame.v1.common.TransportMetadata |   |
+### RecorderOkResponse
+Generic OK response.
+Empty - indicates success
+### RecorderRequest
+Recorder request wrapper.
+| Field | Type | Description |
+|-------|------|-------------|
+| `recorder_id` |  string |   |
+| `get_clips` |  RecorderClipsGetRequest |   |
+| `add_clip` |  RecorderClipAddRequest |   |
+| `remove_clip` |  RecorderClipRemoveRequest |   |
+| `clear_clips` |  RecorderClipsClearRequest |   |
+| `set_metadata` |  RecorderMetadataSetRequest |   |
+| `verify_clips` |  RecorderClipsVerifyRequest |   |
+| `set_clip_flag` |  RecorderClipFlagSetRequest |   |
+| `copy_clip` |  RecorderClipCopyRequest |   |
+| `set_locked_duration` |  RecorderLockedDurationSetRequest |   |
+### RecorderResponse
+Recorder response wrapper.
+| Field | Type | Description |
+|-------|------|-------------|
+| `get_clips_response` |  RecorderClipsGetResponse |   |
+| `ok_response` |  RecorderOkResponse |   |
+| `verify_clips_response` |  RecorderClipsVerifyResponse |   |
+### RecorderStatus
+Recorder status.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` |  string |   |
+---
+## sesame/v1/rpc/rpc.proto
+`sesame.v1.rpc`
+### Event
+Server event notification.
+| Field | Type | Description |
+|-------|------|-------------|
+| `topic` |  sesame.v1.common.EventTopic |   |
+| `payload` |  bytes |   |
+### Message
+Top-level message wrapper.
+All RPC communication uses this message type.
+Exactly one payload field will be set, determining the message type.
+| Field | Type | Description |
+|-------|------|-------------|
+| `request` |  Request |   |
+| `response` |  Response |   |
+| `event` |  Event |   |
+### Request
+RPC request from client to server.
+| Field | Type | Description |
+|-------|------|-------------|
+| `method` |  string |   |
+| `seq` |  uint32 |   |
+| `payload` |  bytes |   |
+### Response
+RPC response from server to client.
+Error handling:
+- If `ok` is true, `payload` contains the serialized success response and
+  `error` should be empty.
+- If `ok` is false, `error` contains a human-readable message and `payload`
+  may be empty or contain a partial diagnostic payload.
+- Transport-level failures (disconnect/timeouts) are not represented here and
+  must be handled by the framing/transport layer.
+| Field | Type | Description |
+|-------|------|-------------|
+| `seq` |  uint32 |   |
+| `ok` |  bool |   |
+| `payload` |  bytes |   |
+| `error` |  string |   |
+---
+## sesame/v1/rpc/service.proto
+`sesame.v1.rpc`
+### SesameAPIService
+Main Sesame API service.
+| Method | Request | Response | Description |
+|--------|---------|----------|-------------|
+| `ExecuteCommandList` | .sesame.v1.commands.CommandList | .sesame.v1.commands.CommandExecutionResponse | Execute a list of commands. |
+| `UpdateSubscriptions` | .sesame.v1.status.SubscriptionRequest | .sesame.v1.common.Empty | Update event subscriptions. |
+| `NotImplemented` | .sesame.v1.common.Empty | .sesame.v1.common.Empty | Not implemented (placeholder). |
+| `RequestEvents` | .sesame.v1.common.Empty | stream .sesame.v1.status.Event | Subscribe to events (server streaming). |
+| `RequestStatus` | .sesame.v1.common.Empty | .sesame.v1.status.Status | Get current system status. |
+| `RequestRecorderOperation` | .sesame.v1.recorder.RecorderRequest | .sesame.v1.recorder.RecorderResponse | Recorder operations. |
+| `StartJob` | .sesame.v1.jobs.JobStartRequest | .sesame.v1.jobs.Job | Job operations. |
+| `AbortJob` | .sesame.v1.jobs.JobAbortRequest | .sesame.v1.jobs.Job | Abort a running job. |
+| `GetJobStatus` | .sesame.v1.jobs.JobStatusRequest | .sesame.v1.jobs.Job | Fetch status for a job. |
+| `ListJobs` | .sesame.v1.jobs.JobListRequest | .sesame.v1.jobs.JobList | List jobs. |
+| `RequestKeyframe` | .sesame.v1.outputs.KeyframeRequest | .sesame.v1.common.Empty | Request keyframe from encoder. |
+| `RequestIODeviceList` | .sesame.v1.common.Empty | .sesame.v1.status.IODeviceListResponse | Get list of I/O devices. |
+---
+## sesame/v1/sources/source.proto
+`sesame.v1.sources`
+### DeinterlaceType
+Deinterlacing mode for interlaced sources.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `DEINTERLACE_TYPE_PROGRESSIVE` | Progressive (no deinterlacing) |
+| 1 | `DEINTERLACE_TYPE_UPPER_FIELD_FIRST` | Upper field first |
+| 2 | `DEINTERLACE_TYPE_LOWER_FIELD_FIRST` | Lower field first |
+| 3 | `DEINTERLACE_TYPE_AUTO` | Auto-detect field order |
+### PreprocessStep
+Video preprocessing step type.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `PREPROCESS_STEP_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `PREPROCESS_STEP_VIDEO_SCOPES` | Video scopes/waveform |
+| 2 | `PREPROCESS_STEP_CHROMA_KEY` | Chroma key |
+| 3 | `PREPROCESS_STEP_BLUR` | Blur effect |
+### SourceTextureSize
+Source texture size for GPU upload.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `SOURCE_TEXTURE_SIZE_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `SOURCE_TEXTURE_SIZE_HD` | HD resolution (1920x1080) |
+| 2 | `SOURCE_TEXTURE_SIZE_4K` | 4K resolution (3840x2160) |
+### SourceTransportCommandType
+Source transport command type.
+| Value | Name | Description |
+|-------|------|-------------|
+| 0 | `SOURCE_TRANSPORT_CMD_UNSPECIFIED` | Unspecified (invalid) |
+| 1 | `SOURCE_TRANSPORT_CMD_STOP` | Stop playback |
+| 2 | `SOURCE_TRANSPORT_CMD_PLAY` | Start playback |
 | 3 | `SOURCE_TRANSPORT_CMD_SEEK` | Seek to position |
 | 4 | `SOURCE_TRANSPORT_CMD_LOOP` | Set loop mode |
-| 5 | `SOURCE_TRANSPORT_CMD_LIVE` | Switch to live |
+| 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,643 @@ 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 |   |
+| `width` |  uint32 |   |
+| `height` |  uint32 |   |
+### DecklinkSourceConfig
+Decklink source configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `device_index` |  uint32 |   |
+| `video_format` |  sesame.v1.common.VideoFormat |   |
+| `sync_group` | optional uint32 |   |
+### EjectPlaylistRequest
+Request to eject playlist from recorder source.
+| Field | Type | Description |
+|-------|------|-------------|
+| `source_id` |  string |   |
+### FileSourceConfig
+Type-specific source payloads.
+| Field | Type | Description |
+|-------|------|-------------|
+| `url` |  string |   |
+### LoadPlaylistRequest
+Request to load a playlist into a recorder source.
+| Field | Type | Description |
+|-------|------|-------------|
+| `source_id` |  string |   |
+| `user_playlist_id` |  string |   |
+| `items` | repeated sesame.v1.recorder.PlaylistItem |   |
+| `start_time_us` | optional int64 |   |
+| `start_index` | optional int64 |   |
+| `material_pos_us` | optional int64 |   |
+### MoqSourceConfig
+| Field | Type | Description |
+|-------|------|-------------|
+| `url` |  string |   |
+| `broadcast` |  string |   |
+| `key` |  string |   |
+| `decode_buffer_frames` |  uint32 |   |
+### RTTSourceConfig
+RTT (Render-to-Texture) source configuration.
+| Field | Type | Description |
+|-------|------|-------------|
+| `rtt_id` |  string |   |
+| `audio_mixes` | repeated string |   |
+| `delay_frames` |  uint32 |   |
+### RecorderSourceConfig
-### DeinterlaceType
+| Field | Type | Description |
+|-------|------|-------------|
+| `recorder_id` |  string |   |
+| `codec` |  sesame.v1.common.CodecType |   |
-| 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 |   |
+| `config` |  SourceConfig |   |
+### SourceCommonConfig
+Shared fields for all source kinds.
-### SourceConfig
 | Field | Type | Description |
 |-------|------|-------------|
-| `common` | SourceCommonConfig | Shared settings |
+| `user_id` |  string |   |
+| `use_as_clock` |  bool |   |
+| `audio_only` |  bool |   |
+| `audio_channels` |  uint32 |   |
+| `loop` |  bool |   |
+| `play_state` |  SourceTransportState |   |
+| `mip_map` |  bool |   |
+| `texture_size` |  SourceTextureSize |   |
+| `deinterlace` |  DeinterlaceType |   |
+| `video_processors` | repeated VideoProcessor |   |
-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 |   |
+| `file` |  FileSourceConfig |   |
+| `recorder` |  RecorderSourceConfig |   |
+| `browser` |  BrowserSourceConfig |   |
+| `rtt` |  RTTSourceConfig |   |
+| `decklink` |  DecklinkSourceConfig |   |
+| `signal_generator` |  SignalGeneratorSourceConfig |   |
+| `system_audio` |  SystemAudioSourceConfig |   |
+| `srt_stream` |  SrtSourceConfig |   |
+| `websocket` |  WebsocketSourceConfig |   |
+| `moq` |  MoqSourceConfig |   |
-**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 |   |
+| `metadata` |  sesame.v1.common.TransportMetadata |   |
-**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 |   |
+| `metadata` |  sesame.v1.common.TransportMetadata |   |
-### 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 |   |
----
-## 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 |   |
+| `type` |  SourceType |   |
+| `user_id` |  string |   |
+| `state` |  sesame.v1.common.ConnectionState |   |
+| `transport_state` |  SourceTransportState |   |
+| `msg` | optional string |   |
+| `url` |  string |   |
+| `width` |  uint32 |   |
+| `height` |  uint32 |   |
+| `fps` |  float |   |
+| `duration_us` |  int64 |   |
+| `play_position_us` |  int64 |   |
+| `video_buf` |  int32 |   |
+| `audio_buf` |  int32 |   |
+| `gpu_buf` |  int32 |   |
+| `audio_channels` |  uint32 |   |
+| `audio_level` |  float |   |
+| `lip_sync_offset_us` |  int64 |   |
+| `decode_timing` |  sesame.v1.status.FrameTiming |   |
+| `video_buf_avg` |  double |   |
+| `srt_stats` | optional sesame.v1.status.SRTReceiveStatistics |   |
-### 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 |   |
+| `cmd_type` |  SourceTransportCommandType |   |
+| `value` |  sesame.v1.common.PropValue |   |
+### 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 |   |
+| `config` |  SourceConfig |   |
-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 |   |
+| `decode_buffer_frames` |  uint32 |   |
-**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 |   |
----
-## 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 |   |
+| `type` |  PreprocessStep |   |
+| `params` | repeated VideoProcessorParam |   |
-| 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 |   |
+| `float_value` |  float |   |
-### 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 |   |
+| `decode_buffer_frames` |  uint32 |   |
 ---
-## 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 |   |
+| `frame_time_avg` |  int32 |   |
+| `frame_time_min` |  int32 |   |
+| `frame_time_max` |  int32 |   |
-### 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 |   |
+| `peak_bytes` |  uint64 |   |
+| `budget_bytes` |  uint64 |   |
-## 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 |   |
+| `packets_received_lost` |  int32 |   |
+| `packet_ack_sent` |  int32 |   |
+| `packet_nack_sent` |  int32 |   |
+| `bytes_received` |  int64 |   |
+| `bytes_received_lost` |  int64 |   |
+| `receive_rate_mbps` |  double |   |
+| `tsbpd_delay` |  int32 |   |
+| `bandwidth_mbps` |  double |   |
+| `rtt_ms` |  double |   |
-### 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 |   |
+| `packets_sent_lost` |  int32 |   |
+| `packets_sent_dropped` |  int32 |   |
+| `packets_retransmitted` |  int32 |   |
+| `packet_ack_received` |  int32 |   |
+| `packet_nack_received` |  int32 |   |
+| `bytes_sent` |  int64 |   |
+| `bytes_sent_dropped` |  int64 |   |
+| `send_rate_mbps` |  double |   |
+| `bandwidth_mbps` |  double |   |
+| `rtt_ms` |  double |   |
-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 |   |
+| `framedrops` |  uint32 |   |
+| `framerate` |  float |   |
+| `gpu_mem` |  uint64 |   |
+| `cpu_mem` |  uint64 |   |
+| `mem_gpu_pool` |  MemoryDomainStats |   |
+| `mem_cpu_pool` |  MemoryDomainStats |   |
+| `mem_gpu_adhoc` |  MemoryDomainStats |   |
+| `mem_gpu_pinned` |  MemoryDomainStats |   |
+| `gpu_mem_total` |  uint64 |   |
+| `gpu_mem_used` |  uint64 |   |
+| `gpu_utilization` |  uint32 |   |
+| `gpu_mem_utilization` |  uint32 |   |
+| `gpu_encoder_utilization` |  uint32 |   |
+| `gpu_decoder_utilization` |  uint32 |   |
+| `gpu_name` |  string |   |
+| `vma_bytes` |  uint64 |   |
 ---
-## 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 |   |
-| 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 |   |
-### 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 |   |
+| `transport_event` |  TransportEvent |   |
+| `callback_event` |  sesame.v1.common.Callback |   |
+| `job_event` |  sesame.v1.jobs.Job |   |
+| `recorder_event` |  sesame.v1.recorder.RecorderEvent |   |
-| 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 |   |
+| `name` |  string |   |
+| `type` |  IODeviceType |   |
-## 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 |   |
-### 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 |   |
+| `render_status_gpu` |  FrameTiming |   |
+| `render_status_cpu` |  FrameTiming |   |
+| `sources` | repeated sesame.v1.sources.SourceStatus |   |
+| `compositions` | repeated CompositorStatus |   |
+| `audio_mixes` | repeated sesame.v1.audio.AudioMixerStatus |   |
+| `outputs` | repeated sesame.v1.outputs.OutputStatus |   |
+| `recorders` | repeated sesame.v1.recorder.RecorderStatus |   |
 ### SubscriptionRequest
+Subscription request.
 | Field | Type | Description |
 |-------|------|-------------|
-| `event_topics` | EventTopic[] | Topics to subscribe to |
-| `channels` | string[] | Dynamic channels (e.g. `media-stream/<id>`) |
+| `event_topics` | repeated sesame.v1.common.EventTopic |   |
+| `channels` | repeated string |   |
+### 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 |   |
+| `user_id` |  string |   |
+| `uri` |  string |   |
+| `state` |  sesame.v1.sources.SourceTransportState |   |
+| `duration_us` |  int64 |   |
+| `position_us` |  int64 |   |
+| `material_position_us` |  int64 |   |
+| `user_time_us` |  int64 |   |
+| `speed` |  float |   |
+| `user_playlist_id` |  string |   |
+| `playlist_index` |  uint32 |   |
+| `playlist_length` |  uint32 |   |
+| `clip_id` |  uint64 |   |
+| `clip_position_us` |  int64 |   |
+| `clip_duration_us` |  int64 |   |
+| `preroll` |  uint32 |   |
+| `postroll` |  uint32 |   |
+| `metadata` |  sesame.v1.common.TransportMetadata |   |
-| 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 |   |
+| `media` |  MediaFrameData |   |
----
-## 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 |   |
+| `keyframe` |  bool |   |
+| `codec_data` |  MediaCodecData |   |
-| 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 +2059,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 +2080,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 +2124,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 +2148,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.x` | float | Clip plane X |
+| `clip-plane.y` | float | Clip plane Y |
+| `clip-plane.z` | float | Clip plane Z |
+| `clip-plane.w` | float | Clip plane W |
 | `feather` | float | Feather amount |
 ### Audio Mixer Domain (`domain.audio_mixer_id`)
@@ -1201,8 +2160,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 +2175,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 |