@pulsefield/protocol 0.0.1 → 0.0.3

package/gen/python/pulsefield/protocol/v1/envelope_pb2.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: pulsefield/protocol/v1/envelope.proto
+# Protobuf Python Version: 5.26.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from pulsefield.protocol.v1 import core_pb2 as pulsefield_dot_protocol_dot_v1_dot_core__pb2
+from pulsefield.protocol.v1 import inference_pb2 as pulsefield_dot_protocol_dot_v1_dot_inference__pb2
+from pulsefield.protocol.v1 import mapper_pb2 as pulsefield_dot_protocol_dot_v1_dot_mapper__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n%pulsefield/protocol/v1/envelope.proto\x12\x16pulsefield.protocol.v1\x1a!pulsefield/protocol/v1/core.proto\x1a&pulsefield/protocol/v1/inference.proto\x1a#pulsefield/protocol/v1/mapper.proto\"\xf7\x07\n\x08\x45nvelope\x12\x1d\n\nsession_id\x18\x01 \x01(\tR\tsessionId\x12\x1a\n\x08sequence\x18\x02 \x01(\x04R\x08sequence\x12%\n\x0fsent_at_unix_ms\x18\x03 \x01(\x03R\x0csentAtUnixMs\x12$\n\x0esource_node_id\x18\x04 \x01(\tR\x0csourceNodeId\x12$\n\x0etarget_node_id\x18\x05 \x01(\tR\x0ctargetNodeId\x12\x1d\n\nmessage_id\x18\x06 \x01(\tR\tmessageId\x12%\n\x0e\x63orrelation_id\x18\x07 \x01(\tR\rcorrelationId\x12\x42\n\nnode_hello\x18\x08 \x01(\x0b\x32!.pulsefield.protocol.v1.NodeHelloH\x00R\tnodeHello\x12<\n\x05ready\x18\n \x01(\x0b\x32$.pulsefield.protocol.v1.ReadyRequestH\x00R\x05ready\x12<\n\x05\x61udio\x18\x0b \x01(\x0b\x32$.pulsefield.protocol.v1.AudioRequestH\x00R\x05\x61udio\x12U\n\x0ereference_time\x18\x0c \x01(\x0b\x32,.pulsefield.protocol.v1.ReferenceTimeRequestH\x00R\rreferenceTime\x12O\n\x0cstop_session\x18\r \x01(\x0b\x32*.pulsefield.protocol.v1.StopSessionRequestH\x00R\x0bstopSession\x12`\n\x13mapper_stream_begin\x18\x13 \x01(\x0b\x32..pulsefield.protocol.v1.MapperStreamBeginEventH\x00R\x11mapperStreamBegin\x12W\n\x10hit_object_token\x18\x14 \x01(\x0b\x32+.pulsefield.protocol.v1.HitObjectTokenEventH\x00R\x0ehitObjectToken\x12:\n\x05\x65rror\x18\x15 \x01(\x0b\x32\".pulsefield.protocol.v1.ErrorEventH\x00R\x05\x65rror\x12=\n\x06status\x18\x16 \x01(\x0b\x32#.pulsefield.protocol.v1.StatusEventH\x00R\x06status\x12N\n\rend_of_stream\x18\x17 \x01(\x0b\x32(.pulsefield.protocol.v1.EndOfStreamEventH\x00R\x0b\x65ndOfStreamB\t\n\x07payloadb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'pulsefield.protocol.v1.envelope_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_ENVELOPE']._serialized_start=178
+  _globals['_ENVELOPE']._serialized_end=1193
+# @@protoc_insertion_point(module_scope)

package/gen/python/pulsefield/protocol/v1/envelope_pb2.pyi

@@ -0,0 +1,46 @@
+from pulsefield.protocol.v1 import core_pb2 as _core_pb2
+from pulsefield.protocol.v1 import inference_pb2 as _inference_pb2
+from pulsefield.protocol.v1 import mapper_pb2 as _mapper_pb2
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Mapping as _Mapping, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class Envelope(_message.Message):
+    __slots__ = ("session_id", "sequence", "sent_at_unix_ms", "source_node_id", "target_node_id", "message_id", "correlation_id", "node_hello", "ready", "audio", "reference_time", "stop_session", "mapper_stream_begin", "hit_object_token", "error", "status", "end_of_stream")
+    SESSION_ID_FIELD_NUMBER: _ClassVar[int]
+    SEQUENCE_FIELD_NUMBER: _ClassVar[int]
+    SENT_AT_UNIX_MS_FIELD_NUMBER: _ClassVar[int]
+    SOURCE_NODE_ID_FIELD_NUMBER: _ClassVar[int]
+    TARGET_NODE_ID_FIELD_NUMBER: _ClassVar[int]
+    MESSAGE_ID_FIELD_NUMBER: _ClassVar[int]
+    CORRELATION_ID_FIELD_NUMBER: _ClassVar[int]
+    NODE_HELLO_FIELD_NUMBER: _ClassVar[int]
+    READY_FIELD_NUMBER: _ClassVar[int]
+    AUDIO_FIELD_NUMBER: _ClassVar[int]
+    REFERENCE_TIME_FIELD_NUMBER: _ClassVar[int]
+    STOP_SESSION_FIELD_NUMBER: _ClassVar[int]
+    MAPPER_STREAM_BEGIN_FIELD_NUMBER: _ClassVar[int]
+    HIT_OBJECT_TOKEN_FIELD_NUMBER: _ClassVar[int]
+    ERROR_FIELD_NUMBER: _ClassVar[int]
+    STATUS_FIELD_NUMBER: _ClassVar[int]
+    END_OF_STREAM_FIELD_NUMBER: _ClassVar[int]
+    session_id: str
+    sequence: int
+    sent_at_unix_ms: int
+    source_node_id: str
+    target_node_id: str
+    message_id: str
+    correlation_id: str
+    node_hello: _core_pb2.NodeHello
+    ready: _inference_pb2.ReadyRequest
+    audio: _inference_pb2.AudioRequest
+    reference_time: _inference_pb2.ReferenceTimeRequest
+    stop_session: _inference_pb2.StopSessionRequest
+    mapper_stream_begin: _mapper_pb2.MapperStreamBeginEvent
+    hit_object_token: _mapper_pb2.HitObjectTokenEvent
+    error: _inference_pb2.ErrorEvent
+    status: _inference_pb2.StatusEvent
+    end_of_stream: _inference_pb2.EndOfStreamEvent
+    def __init__(self, session_id: _Optional[str] = ..., sequence: _Optional[int] = ..., sent_at_unix_ms: _Optional[int] = ..., source_node_id: _Optional[str] = ..., target_node_id: _Optional[str] = ..., message_id: _Optional[str] = ..., correlation_id: _Optional[str] = ..., node_hello: _Optional[_Union[_core_pb2.NodeHello, _Mapping]] = ..., ready: _Optional[_Union[_inference_pb2.ReadyRequest, _Mapping]] = ..., audio: _Optional[_Union[_inference_pb2.AudioRequest, _Mapping]] = ..., reference_time: _Optional[_Union[_inference_pb2.ReferenceTimeRequest, _Mapping]] = ..., stop_session: _Optional[_Union[_inference_pb2.StopSessionRequest, _Mapping]] = ..., mapper_stream_begin: _Optional[_Union[_mapper_pb2.MapperStreamBeginEvent, _Mapping]] = ..., hit_object_token: _Optional[_Union[_mapper_pb2.HitObjectTokenEvent, _Mapping]] = ..., error: _Optional[_Union[_inference_pb2.ErrorEvent, _Mapping]] = ..., status: _Optional[_Union[_inference_pb2.StatusEvent, _Mapping]] = ..., end_of_stream: _Optional[_Union[_inference_pb2.EndOfStreamEvent, _Mapping]] = ...) -> None: ...

package/gen/python/pulsefield/protocol/v1/inference_pb2.py

@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: pulsefield/protocol/v1/inference.proto
+# Protobuf Python Version: 5.26.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n&pulsefield/protocol/v1/inference.proto\x12\x16pulsefield.protocol.v1\"\x0e\n\x0cReadyRequest\"\xdc\x01\n\rAudioAssetRef\x12\x1f\n\nlocal_path\x18\x01 \x01(\tH\x00R\tlocalPath\x12\x12\n\x03uri\x18\x02 \x01(\tH\x00R\x03uri\x12\x1b\n\x08\x61sset_id\x18\x03 \x01(\tH\x00R\x07\x61ssetId\x12+\n\x0f\x61udio_length_ms\x18\n \x01(\rH\x01R\raudioLengthMs\x88\x01\x01\x12\"\n\nsha256_hex\x18\x0b \x01(\tH\x02R\tsha256Hex\x88\x01\x01\x42\x05\n\x03refB\x12\n\x10_audio_length_msB\r\n\x0b_sha256_hex\"\x82\x02\n\x0c\x41udioRequest\x12;\n\x05\x61udio\x18\x01 \x01(\x0b\x32%.pulsefield.protocol.v1.AudioAssetRefR\x05\x61udio\x12\x43\n\x0bsync_source\x18\x02 \x01(\x0e\x32\".pulsefield.protocol.v1.SyncSourceR\nsyncSource\x12#\n\ndifficulty\x18\x03 \x01(\x01H\x00R\ndifficulty\x88\x01\x01\x12<\n\x05route\x18\x04 \x01(\x0e\x32&.pulsefield.protocol.v1.InferenceRouteR\x05routeB\r\n\x0b_difficulty\"\xad\x01\n\x14ReferenceTimeRequest\x12\x1e\n\x0bref_time_ms\x18\x01 \x01(\rR\trefTimeMs\x12\x34\n\x17local_host_time_send_ms\x18\x02 \x01(\x04R\x13localHostTimeSendMs\x12+\n\x0f\x61udio_length_ms\x18\x03 \x01(\rH\x00R\raudioLengthMs\x88\x01\x01\x42\x12\n\x10_audio_length_ms\",\n\x12StopSessionRequest\x12\x16\n\x06reason\x18\x01 \x01(\tR\x06reason\"\xf8\x01\n\nErrorEvent\x12\x12\n\x04\x63ode\x18\x01 \x01(\tR\x04\x63ode\x12\x18\n\x07message\x18\x02 \x01(\tR\x07message\x12I\n\nerror_code\x18\x03 \x01(\x0e\x32*.pulsefield.protocol.v1.InferenceErrorCodeR\terrorCode\x12\x14\n\x05phase\x18\x04 \x01(\tR\x05phase\x12<\n\x05route\x18\x05 \x01(\x0e\x32&.pulsefield.protocol.v1.InferenceRouteR\x05route\x12\x1d\n\nerror_kind\x18\x06 \x01(\tR\terrorKind\"\xdb\x04\n\x0bStatusEvent\x12>\n\x06status\x18\x01 \x01(\x0e\x32&.pulsefield.protocol.v1.EndpointStatusR\x06status\x12\x18\n\x07message\x18\x02 \x01(\tR\x07message\x12#\n\x0bref_time_ms\x18\x03 \x01(\rH\x00R\trefTimeMs\x88\x01\x01\x12\x33\n\x13sender_monotonic_ms\x18\x04 \x01(\x04H\x01R\x11senderMonotonicMs\x88\x01\x01\x12G\n\x0b\x66rom_status\x18\x05 \x01(\x0e\x32&.pulsefield.protocol.v1.EndpointStatusR\nfromStatus\x12\x16\n\x06reason\x18\x06 \x01(\tR\x06reason\x12+\n\x0f\x61udio_length_ms\x18\x07 \x01(\rH\x02R\raudioLengthMs\x88\x01\x01\x12>\n\x19reset_sender_monotonic_ms\x18\x08 \x01(\x04H\x03R\x16resetSenderMonotonicMs\x88\x01\x01\x12<\n\x05route\x18\t \x01(\x0e\x32&.pulsefield.protocol.v1.InferenceRouteR\x05route\x12#\n\ndifficulty\x18\n \x01(\x01H\x04R\ndifficulty\x88\x01\x01\x42\x0e\n\x0c_ref_time_msB\x16\n\x14_sender_monotonic_msB\x12\n\x10_audio_length_msB\x1c\n\x1a_reset_sender_monotonic_msB\r\n\x0b_difficulty\"\x83\x01\n\x10\x45ndOfStreamEvent\x12+\n\x0f\x61udio_length_ms\x18\x01 \x01(\rH\x00R\raudioLengthMs\x88\x01\x01\x12.\n\x13\x63omplete_through_ms\x18\x02 \x01(\rR\x11\x63ompleteThroughMsB\x12\n\x10_audio_length_ms*c\n\nSyncSource\x12\x1b\n\x17SYNC_SOURCE_UNSPECIFIED\x10\x00\x12\x1a\n\x16SYNC_SOURCE_BACKGROUND\x10\x01\x12\x1c\n\x18SYNC_SOURCE_SYSTEM_AUDIO\x10\x02*n\n\x0eInferenceRoute\x12\x1f\n\x1bINFERENCE_ROUTE_UNSPECIFIED\x10\x00\x12\x1a\n\x16INFERENCE_ROUTE_MAPPER\x10\x01\x12\x1f\n\x1bINFERENCE_ROUTE_TIMING_MOCK\x10\x02*\xa4\x02\n\x0e\x45ndpointStatus\x12\x1f\n\x1b\x45NDPOINT_STATUS_UNSPECIFIED\x10\x00\x12\x19\n\x15\x45NDPOINT_STATUS_READY\x10\x01\x12#\n\x1f\x45NDPOINT_STATUS_AUDIO_PREPARING\x10\x02\x12\x1f\n\x1b\x45NDPOINT_STATUS_AUDIO_READY\x10\x03\x12\x1d\n\x19\x45NDPOINT_STATUS_STREAMING\x10\x04\x12\x1b\n\x17\x45NDPOINT_STATUS_STOPPED\x10\x05\x12\x1a\n\x16\x45NDPOINT_STATUS_FAILED\x10\x06\x12\x18\n\x14\x45NDPOINT_STATUS_COLD\x10\x07\x12\x1e\n\x1a\x45NDPOINT_STATUS_NO_SESSION\x10\x08*\x9b\x03\n\x12InferenceErrorCode\x12$\n INFERENCE_ERROR_CODE_UNSPECIFIED\x10\x00\x12\'\n#INFERENCE_ERROR_CODE_PROTOCOL_ERROR\x10\x01\x12\'\n#INFERENCE_ERROR_CODE_INVALID_DEVICE\x10\x02\x12(\n$INFERENCE_ERROR_CODE_AUDIO_NOT_FOUND\x10\x03\x12)\n%INFERENCE_ERROR_CODE_INFERENCE_FAILED\x10\x04\x12*\n&INFERENCE_ERROR_CODE_SESSION_NOT_FOUND\x10\x05\x12\x33\n/INFERENCE_ERROR_CODE_SESSION_OWNERSHIP_CONFLICT\x10\x06\x12+\n\'INFERENCE_ERROR_CODE_AUDIO_NOT_PREPARED\x10\x07\x12*\n&INFERENCE_ERROR_CODE_UNSUPPORTED_ROUTE\x10\x08\x62\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'pulsefield.protocol.v1.inference_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_SYNCSOURCE']._serialized_start=1779
+  _globals['_SYNCSOURCE']._serialized_end=1878
+  _globals['_INFERENCEROUTE']._serialized_start=1880
+  _globals['_INFERENCEROUTE']._serialized_end=1990
+  _globals['_ENDPOINTSTATUS']._serialized_start=1993
+  _globals['_ENDPOINTSTATUS']._serialized_end=2285
+  _globals['_INFERENCEERRORCODE']._serialized_start=2288
+  _globals['_INFERENCEERRORCODE']._serialized_end=2699
+  _globals['_READYREQUEST']._serialized_start=66
+  _globals['_READYREQUEST']._serialized_end=80
+  _globals['_AUDIOASSETREF']._serialized_start=83
+  _globals['_AUDIOASSETREF']._serialized_end=303
+  _globals['_AUDIOREQUEST']._serialized_start=306
+  _globals['_AUDIOREQUEST']._serialized_end=564
+  _globals['_REFERENCETIMEREQUEST']._serialized_start=567
+  _globals['_REFERENCETIMEREQUEST']._serialized_end=740
+  _globals['_STOPSESSIONREQUEST']._serialized_start=742
+  _globals['_STOPSESSIONREQUEST']._serialized_end=786
+  _globals['_ERROREVENT']._serialized_start=789
+  _globals['_ERROREVENT']._serialized_end=1037
+  _globals['_STATUSEVENT']._serialized_start=1040
+  _globals['_STATUSEVENT']._serialized_end=1643
+  _globals['_ENDOFSTREAMEVENT']._serialized_start=1646
+  _globals['_ENDOFSTREAMEVENT']._serialized_end=1777
+# @@protoc_insertion_point(module_scope)

package/gen/python/pulsefield/protocol/v1/inference_pb2.pyi

@@ -0,0 +1,160 @@
+from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Mapping as _Mapping, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class SyncSource(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+    __slots__ = ()
+    SYNC_SOURCE_UNSPECIFIED: _ClassVar[SyncSource]
+    SYNC_SOURCE_BACKGROUND: _ClassVar[SyncSource]
+    SYNC_SOURCE_SYSTEM_AUDIO: _ClassVar[SyncSource]
+
+class InferenceRoute(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+    __slots__ = ()
+    INFERENCE_ROUTE_UNSPECIFIED: _ClassVar[InferenceRoute]
+    INFERENCE_ROUTE_MAPPER: _ClassVar[InferenceRoute]
+    INFERENCE_ROUTE_TIMING_MOCK: _ClassVar[InferenceRoute]
+
+class EndpointStatus(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+    __slots__ = ()
+    ENDPOINT_STATUS_UNSPECIFIED: _ClassVar[EndpointStatus]
+    ENDPOINT_STATUS_READY: _ClassVar[EndpointStatus]
+    ENDPOINT_STATUS_AUDIO_PREPARING: _ClassVar[EndpointStatus]
+    ENDPOINT_STATUS_AUDIO_READY: _ClassVar[EndpointStatus]
+    ENDPOINT_STATUS_STREAMING: _ClassVar[EndpointStatus]
+    ENDPOINT_STATUS_STOPPED: _ClassVar[EndpointStatus]
+    ENDPOINT_STATUS_FAILED: _ClassVar[EndpointStatus]
+    ENDPOINT_STATUS_COLD: _ClassVar[EndpointStatus]
+    ENDPOINT_STATUS_NO_SESSION: _ClassVar[EndpointStatus]
+
+class InferenceErrorCode(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+    __slots__ = ()
+    INFERENCE_ERROR_CODE_UNSPECIFIED: _ClassVar[InferenceErrorCode]
+    INFERENCE_ERROR_CODE_PROTOCOL_ERROR: _ClassVar[InferenceErrorCode]
+    INFERENCE_ERROR_CODE_INVALID_DEVICE: _ClassVar[InferenceErrorCode]
+    INFERENCE_ERROR_CODE_AUDIO_NOT_FOUND: _ClassVar[InferenceErrorCode]
+    INFERENCE_ERROR_CODE_INFERENCE_FAILED: _ClassVar[InferenceErrorCode]
+    INFERENCE_ERROR_CODE_SESSION_NOT_FOUND: _ClassVar[InferenceErrorCode]
+    INFERENCE_ERROR_CODE_SESSION_OWNERSHIP_CONFLICT: _ClassVar[InferenceErrorCode]
+    INFERENCE_ERROR_CODE_AUDIO_NOT_PREPARED: _ClassVar[InferenceErrorCode]
+    INFERENCE_ERROR_CODE_UNSUPPORTED_ROUTE: _ClassVar[InferenceErrorCode]
+SYNC_SOURCE_UNSPECIFIED: SyncSource
+SYNC_SOURCE_BACKGROUND: SyncSource
+SYNC_SOURCE_SYSTEM_AUDIO: SyncSource
+INFERENCE_ROUTE_UNSPECIFIED: InferenceRoute
+INFERENCE_ROUTE_MAPPER: InferenceRoute
+INFERENCE_ROUTE_TIMING_MOCK: InferenceRoute
+ENDPOINT_STATUS_UNSPECIFIED: EndpointStatus
+ENDPOINT_STATUS_READY: EndpointStatus
+ENDPOINT_STATUS_AUDIO_PREPARING: EndpointStatus
+ENDPOINT_STATUS_AUDIO_READY: EndpointStatus
+ENDPOINT_STATUS_STREAMING: EndpointStatus
+ENDPOINT_STATUS_STOPPED: EndpointStatus
+ENDPOINT_STATUS_FAILED: EndpointStatus
+ENDPOINT_STATUS_COLD: EndpointStatus
+ENDPOINT_STATUS_NO_SESSION: EndpointStatus
+INFERENCE_ERROR_CODE_UNSPECIFIED: InferenceErrorCode
+INFERENCE_ERROR_CODE_PROTOCOL_ERROR: InferenceErrorCode
+INFERENCE_ERROR_CODE_INVALID_DEVICE: InferenceErrorCode
+INFERENCE_ERROR_CODE_AUDIO_NOT_FOUND: InferenceErrorCode
+INFERENCE_ERROR_CODE_INFERENCE_FAILED: InferenceErrorCode
+INFERENCE_ERROR_CODE_SESSION_NOT_FOUND: InferenceErrorCode
+INFERENCE_ERROR_CODE_SESSION_OWNERSHIP_CONFLICT: InferenceErrorCode
+INFERENCE_ERROR_CODE_AUDIO_NOT_PREPARED: InferenceErrorCode
+INFERENCE_ERROR_CODE_UNSUPPORTED_ROUTE: InferenceErrorCode
+
+class ReadyRequest(_message.Message):
+    __slots__ = ()
+    def __init__(self) -> None: ...
+
+class AudioAssetRef(_message.Message):
+    __slots__ = ("local_path", "uri", "asset_id", "audio_length_ms", "sha256_hex")
+    LOCAL_PATH_FIELD_NUMBER: _ClassVar[int]
+    URI_FIELD_NUMBER: _ClassVar[int]
+    ASSET_ID_FIELD_NUMBER: _ClassVar[int]
+    AUDIO_LENGTH_MS_FIELD_NUMBER: _ClassVar[int]
+    SHA256_HEX_FIELD_NUMBER: _ClassVar[int]
+    local_path: str
+    uri: str
+    asset_id: str
+    audio_length_ms: int
+    sha256_hex: str
+    def __init__(self, local_path: _Optional[str] = ..., uri: _Optional[str] = ..., asset_id: _Optional[str] = ..., audio_length_ms: _Optional[int] = ..., sha256_hex: _Optional[str] = ...) -> None: ...
+
+class AudioRequest(_message.Message):
+    __slots__ = ("audio", "sync_source", "difficulty", "route")
+    AUDIO_FIELD_NUMBER: _ClassVar[int]
+    SYNC_SOURCE_FIELD_NUMBER: _ClassVar[int]
+    DIFFICULTY_FIELD_NUMBER: _ClassVar[int]
+    ROUTE_FIELD_NUMBER: _ClassVar[int]
+    audio: AudioAssetRef
+    sync_source: SyncSource
+    difficulty: float
+    route: InferenceRoute
+    def __init__(self, audio: _Optional[_Union[AudioAssetRef, _Mapping]] = ..., sync_source: _Optional[_Union[SyncSource, str]] = ..., difficulty: _Optional[float] = ..., route: _Optional[_Union[InferenceRoute, str]] = ...) -> None: ...
+
+class ReferenceTimeRequest(_message.Message):
+    __slots__ = ("ref_time_ms", "local_host_time_send_ms", "audio_length_ms")
+    REF_TIME_MS_FIELD_NUMBER: _ClassVar[int]
+    LOCAL_HOST_TIME_SEND_MS_FIELD_NUMBER: _ClassVar[int]
+    AUDIO_LENGTH_MS_FIELD_NUMBER: _ClassVar[int]
+    ref_time_ms: int
+    local_host_time_send_ms: int
+    audio_length_ms: int
+    def __init__(self, ref_time_ms: _Optional[int] = ..., local_host_time_send_ms: _Optional[int] = ..., audio_length_ms: _Optional[int] = ...) -> None: ...
+
+class StopSessionRequest(_message.Message):
+    __slots__ = ("reason",)
+    REASON_FIELD_NUMBER: _ClassVar[int]
+    reason: str
+    def __init__(self, reason: _Optional[str] = ...) -> None: ...
+
+class ErrorEvent(_message.Message):
+    __slots__ = ("code", "message", "error_code", "phase", "route", "error_kind")
+    CODE_FIELD_NUMBER: _ClassVar[int]
+    MESSAGE_FIELD_NUMBER: _ClassVar[int]
+    ERROR_CODE_FIELD_NUMBER: _ClassVar[int]
+    PHASE_FIELD_NUMBER: _ClassVar[int]
+    ROUTE_FIELD_NUMBER: _ClassVar[int]
+    ERROR_KIND_FIELD_NUMBER: _ClassVar[int]
+    code: str
+    message: str
+    error_code: InferenceErrorCode
+    phase: str
+    route: InferenceRoute
+    error_kind: str
+    def __init__(self, code: _Optional[str] = ..., message: _Optional[str] = ..., error_code: _Optional[_Union[InferenceErrorCode, str]] = ..., phase: _Optional[str] = ..., route: _Optional[_Union[InferenceRoute, str]] = ..., error_kind: _Optional[str] = ...) -> None: ...
+
+class StatusEvent(_message.Message):
+    __slots__ = ("status", "message", "ref_time_ms", "sender_monotonic_ms", "from_status", "reason", "audio_length_ms", "reset_sender_monotonic_ms", "route", "difficulty")
+    STATUS_FIELD_NUMBER: _ClassVar[int]
+    MESSAGE_FIELD_NUMBER: _ClassVar[int]
+    REF_TIME_MS_FIELD_NUMBER: _ClassVar[int]
+    SENDER_MONOTONIC_MS_FIELD_NUMBER: _ClassVar[int]
+    FROM_STATUS_FIELD_NUMBER: _ClassVar[int]
+    REASON_FIELD_NUMBER: _ClassVar[int]
+    AUDIO_LENGTH_MS_FIELD_NUMBER: _ClassVar[int]
+    RESET_SENDER_MONOTONIC_MS_FIELD_NUMBER: _ClassVar[int]
+    ROUTE_FIELD_NUMBER: _ClassVar[int]
+    DIFFICULTY_FIELD_NUMBER: _ClassVar[int]
+    status: EndpointStatus
+    message: str
+    ref_time_ms: int
+    sender_monotonic_ms: int
+    from_status: EndpointStatus
+    reason: str
+    audio_length_ms: int
+    reset_sender_monotonic_ms: int
+    route: InferenceRoute
+    difficulty: float
+    def __init__(self, status: _Optional[_Union[EndpointStatus, str]] = ..., message: _Optional[str] = ..., ref_time_ms: _Optional[int] = ..., sender_monotonic_ms: _Optional[int] = ..., from_status: _Optional[_Union[EndpointStatus, str]] = ..., reason: _Optional[str] = ..., audio_length_ms: _Optional[int] = ..., reset_sender_monotonic_ms: _Optional[int] = ..., route: _Optional[_Union[InferenceRoute, str]] = ..., difficulty: _Optional[float] = ...) -> None: ...
+
+class EndOfStreamEvent(_message.Message):
+    __slots__ = ("audio_length_ms", "complete_through_ms")
+    AUDIO_LENGTH_MS_FIELD_NUMBER: _ClassVar[int]
+    COMPLETE_THROUGH_MS_FIELD_NUMBER: _ClassVar[int]
+    audio_length_ms: int
+    complete_through_ms: int
+    def __init__(self, audio_length_ms: _Optional[int] = ..., complete_through_ms: _Optional[int] = ...) -> None: ...

package/gen/python/pulsefield/protocol/v1/mapper_pb2.py

@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: pulsefield/protocol/v1/mapper.proto
+# Protobuf Python Version: 5.26.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n#pulsefield/protocol/v1/mapper.proto\x12\x16pulsefield.protocol.v1\"\x9c\x01\n\x16MapperStreamBeginEvent\x12\x34\n\x16token_contract_version\x18\x02 \x01(\rR\x14tokenContractVersion\x12+\n\x0f\x61udio_length_ms\x18\x03 \x01(\rH\x00R\raudioLengthMs\x88\x01\x01\x42\x12\n\x10_audio_length_msJ\x04\x08\x01\x10\x02R\x05route\"x\n\x13HitObjectTokenEvent\x12\x19\n\x08token_id\x18\x01 \x01(\rR\x07tokenId\x12%\n\x0fms_in_ref_audio\x18\x02 \x01(\rR\x0cmsInRefAudio\x12\x1f\n\x0btoken_index\x18\x03 \x01(\rR\ntokenIndexb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'pulsefield.protocol.v1.mapper_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_MAPPERSTREAMBEGINEVENT']._serialized_start=64
+  _globals['_MAPPERSTREAMBEGINEVENT']._serialized_end=220
+  _globals['_HITOBJECTTOKENEVENT']._serialized_start=222
+  _globals['_HITOBJECTTOKENEVENT']._serialized_end=342
+# @@protoc_insertion_point(module_scope)

package/gen/python/pulsefield/protocol/v1/mapper_pb2.pyi

@@ -0,0 +1,23 @@
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Optional as _Optional
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class MapperStreamBeginEvent(_message.Message):
+    __slots__ = ("token_contract_version", "audio_length_ms")
+    TOKEN_CONTRACT_VERSION_FIELD_NUMBER: _ClassVar[int]
+    AUDIO_LENGTH_MS_FIELD_NUMBER: _ClassVar[int]
+    token_contract_version: int
+    audio_length_ms: int
+    def __init__(self, token_contract_version: _Optional[int] = ..., audio_length_ms: _Optional[int] = ...) -> None: ...
+
+class HitObjectTokenEvent(_message.Message):
+    __slots__ = ("token_id", "ms_in_ref_audio", "token_index")
+    TOKEN_ID_FIELD_NUMBER: _ClassVar[int]
+    MS_IN_REF_AUDIO_FIELD_NUMBER: _ClassVar[int]
+    TOKEN_INDEX_FIELD_NUMBER: _ClassVar[int]
+    token_id: int
+    ms_in_ref_audio: int
+    token_index: int
+    def __init__(self, token_id: _Optional[int] = ..., ms_in_ref_audio: _Optional[int] = ..., token_index: _Optional[int] = ...) -> None: ...

package/gen/swift/pulsefield/protocol/v1/core.pb.swift

@@ -0,0 +1,323 @@
+// DO NOT EDIT.
+// swift-format-ignore-file
+// swiftlint:disable all
+//
+// Generated by the Swift generator plugin for the protocol buffer compiler.
+// Source: pulsefield/protocol/v1/core.proto
+//
+// For information on using the generated types, please see the documentation:
+//   https://github.com/apple/swift-protobuf/
+
+import SwiftProtobuf
+
+// If the compiler emits an error on this type, it is because this file
+// was generated by a version of the `protoc` Swift plug-in that is
+// incompatible with the version of SwiftProtobuf to which you are linking.
+// Please ensure that you are building against the same version of the API
+// that was used to generate this file.
+fileprivate nonisolated struct _GeneratedWithProtocGenSwiftVersion: SwiftProtobuf.ProtobufAPIVersionCheck {
+  struct _2: SwiftProtobuf.ProtobufAPIVersion_2 {}
+  typealias Version = _2
+}
+
+public nonisolated enum Pulsefield_Protocol_V1_NodeRole: SwiftProtobuf.Enum, Swift.CaseIterable {
+  public typealias RawValue = Int
+  case unspecified // = 0
+  case host // = 1
+  case playerClient // = 2
+  case modelService // = 3
+  case hardware // = 4
+  case debugTool // = 5
+  case UNRECOGNIZED(Int)
+
+  public init() {
+    self = .unspecified
+  }
+
+  public init?(rawValue: Int) {
+    switch rawValue {
+    case 0: self = .unspecified
+    case 1: self = .host
+    case 2: self = .playerClient
+    case 3: self = .modelService
+    case 4: self = .hardware
+    case 5: self = .debugTool
+    default: self = .UNRECOGNIZED(rawValue)
+    }
+  }
+
+  public var rawValue: Int {
+    switch self {
+    case .unspecified: return 0
+    case .host: return 1
+    case .playerClient: return 2
+    case .modelService: return 3
+    case .hardware: return 4
+    case .debugTool: return 5
+    case .UNRECOGNIZED(let i): return i
+    }
+  }
+
+  // The compiler won't synthesize support with the UNRECOGNIZED case.
+  public static let allCases: [Pulsefield_Protocol_V1_NodeRole] = [
+    .unspecified,
+    .host,
+    .playerClient,
+    .modelService,
+    .hardware,
+    .debugTool,
+  ]
+
+}
+
+public nonisolated enum Pulsefield_Protocol_V1_NodeCapabilityKind: SwiftProtobuf.Enum, Swift.CaseIterable {
+  public typealias RawValue = Int
+  case unspecified // = 0
+  case recognition // = 1
+  case timing // = 2
+  case mapper // = 3
+  case playerStream // = 4
+  case hardware // = 5
+  case debug // = 6
+  case UNRECOGNIZED(Int)
+
+  public init() {
+    self = .unspecified
+  }
+
+  public init?(rawValue: Int) {
+    switch rawValue {
+    case 0: self = .unspecified
+    case 1: self = .recognition
+    case 2: self = .timing
+    case 3: self = .mapper
+    case 4: self = .playerStream
+    case 5: self = .hardware
+    case 6: self = .debug
+    default: self = .UNRECOGNIZED(rawValue)
+    }
+  }
+
+  public var rawValue: Int {
+    switch self {
+    case .unspecified: return 0
+    case .recognition: return 1
+    case .timing: return 2
+    case .mapper: return 3
+    case .playerStream: return 4
+    case .hardware: return 5
+    case .debug: return 6
+    case .UNRECOGNIZED(let i): return i
+    }
+  }
+
+  // The compiler won't synthesize support with the UNRECOGNIZED case.
+  public static let allCases: [Pulsefield_Protocol_V1_NodeCapabilityKind] = [
+    .unspecified,
+    .recognition,
+    .timing,
+    .mapper,
+    .playerStream,
+    .hardware,
+    .debug,
+  ]
+
+}
+
+public nonisolated enum Pulsefield_Protocol_V1_NodeCapabilityDirection: SwiftProtobuf.Enum, Swift.CaseIterable {
+  public typealias RawValue = Int
+  case unspecified // = 0
+  case producer // = 1
+  case consumer // = 2
+  case bidirectional // = 3
+  case UNRECOGNIZED(Int)
+
+  public init() {
+    self = .unspecified
+  }
+
+  public init?(rawValue: Int) {
+    switch rawValue {
+    case 0: self = .unspecified
+    case 1: self = .producer
+    case 2: self = .consumer
+    case 3: self = .bidirectional
+    default: self = .UNRECOGNIZED(rawValue)
+    }
+  }
+
+  public var rawValue: Int {
+    switch self {
+    case .unspecified: return 0
+    case .producer: return 1
+    case .consumer: return 2
+    case .bidirectional: return 3
+    case .UNRECOGNIZED(let i): return i
+    }
+  }
+
+  // The compiler won't synthesize support with the UNRECOGNIZED case.
+  public static let allCases: [Pulsefield_Protocol_V1_NodeCapabilityDirection] = [
+    .unspecified,
+    .producer,
+    .consumer,
+    .bidirectional,
+  ]
+
+}
+
+/// Capability advertised by a node before domain-specific traffic begins.
+public nonisolated struct Pulsefield_Protocol_V1_NodeCapability: Sendable {
+  // SwiftProtobuf.Message conformance is added in an extension below. See the
+  // `Message` and `Message+*Additions` files in the SwiftProtobuf library for
+  // methods supported on all messages.
+
+  public var kind: Pulsefield_Protocol_V1_NodeCapabilityKind = .unspecified
+
+  /// Stable capability identifier, such as "mapper.tuple_tokens" or "hardware.input".
+  public var name: String = String()
+
+  /// Capability-specific contract or implementation version.
+  public var version: String = String()
+
+  public var direction: Pulsefield_Protocol_V1_NodeCapabilityDirection = .unspecified
+
+  public var unknownFields = SwiftProtobuf.UnknownStorage()
+
+  public init() {}
+}
+
+/// Initial topology announcement for apps, services, tools, and hardware bridges.
+public nonisolated struct Pulsefield_Protocol_V1_NodeHello: Sendable {
+  // SwiftProtobuf.Message conformance is added in an extension below. See the
+  // `Message` and `Message+*Additions` files in the SwiftProtobuf library for
+  // methods supported on all messages.
+
+  /// Stable node identifier within a Pulsefield graph or room.
+  public var nodeID: String = String()
+
+  public var role: Pulsefield_Protocol_V1_NodeRole = .unspecified
+
+  public var capabilities: [Pulsefield_Protocol_V1_NodeCapability] = []
+
+  /// Protocol package version spoken by this node, such as "0.0.3".
+  public var protocolVersion: String = String()
+
+  /// Stable application or service identifier, such as "pulsefield.host".
+  public var appID: String = String()
+
+  public var unknownFields = SwiftProtobuf.UnknownStorage()
+
+  public init() {}
+}
+
+// MARK: - Code below here is support for the SwiftProtobuf runtime.
+
+fileprivate nonisolated let _protobuf_package = "pulsefield.protocol.v1"
+
+nonisolated extension Pulsefield_Protocol_V1_NodeRole: SwiftProtobuf._ProtoNameProviding {
+  public static let _protobuf_nameMap = SwiftProtobuf._NameMap(bytecode: "\0\u{2}\0NODE_ROLE_UNSPECIFIED\0\u{1}NODE_ROLE_HOST\0\u{1}NODE_ROLE_PLAYER_CLIENT\0\u{1}NODE_ROLE_MODEL_SERVICE\0\u{1}NODE_ROLE_HARDWARE\0\u{1}NODE_ROLE_DEBUG_TOOL\0")
+}
+
+nonisolated extension Pulsefield_Protocol_V1_NodeCapabilityKind: SwiftProtobuf._ProtoNameProviding {
+  public static let _protobuf_nameMap = SwiftProtobuf._NameMap(bytecode: "\0\u{2}\0NODE_CAPABILITY_KIND_UNSPECIFIED\0\u{1}NODE_CAPABILITY_KIND_RECOGNITION\0\u{1}NODE_CAPABILITY_KIND_TIMING\0\u{1}NODE_CAPABILITY_KIND_MAPPER\0\u{1}NODE_CAPABILITY_KIND_PLAYER_STREAM\0\u{1}NODE_CAPABILITY_KIND_HARDWARE\0\u{1}NODE_CAPABILITY_KIND_DEBUG\0")
+}
+
+nonisolated extension Pulsefield_Protocol_V1_NodeCapabilityDirection: SwiftProtobuf._ProtoNameProviding {
+  public static let _protobuf_nameMap = SwiftProtobuf._NameMap(bytecode: "\0\u{2}\0NODE_CAPABILITY_DIRECTION_UNSPECIFIED\0\u{1}NODE_CAPABILITY_DIRECTION_PRODUCER\0\u{1}NODE_CAPABILITY_DIRECTION_CONSUMER\0\u{1}NODE_CAPABILITY_DIRECTION_BIDIRECTIONAL\0")
+}
+
+nonisolated extension Pulsefield_Protocol_V1_NodeCapability: SwiftProtobuf.Message, SwiftProtobuf._MessageImplementationBase, SwiftProtobuf._ProtoNameProviding {
+  public static let protoMessageName: String = _protobuf_package + ".NodeCapability"
+  public static let _protobuf_nameMap = SwiftProtobuf._NameMap(bytecode: "\0\u{1}kind\0\u{1}name\0\u{1}version\0\u{1}direction\0")
+
+  public mutating func decodeMessage<D: SwiftProtobuf.Decoder>(decoder: inout D) throws {
+    while let fieldNumber = try decoder.nextFieldNumber() {
+      // The use of inline closures is to circumvent an issue where the compiler
+      // allocates stack space for every case branch when no optimizations are
+      // enabled. https://github.com/apple/swift-protobuf/issues/1034
+      switch fieldNumber {
+      case 1: try { try decoder.decodeSingularEnumField(value: &self.kind) }()
+      case 2: try { try decoder.decodeSingularStringField(value: &self.name) }()
+      case 3: try { try decoder.decodeSingularStringField(value: &self.version) }()
+      case 4: try { try decoder.decodeSingularEnumField(value: &self.direction) }()
+      default: break
+      }
+    }
+  }
+
+  public func traverse<V: SwiftProtobuf.Visitor>(visitor: inout V) throws {
+    if self.kind != .unspecified {
+      try visitor.visitSingularEnumField(value: self.kind, fieldNumber: 1)
+    }
+    if !self.name.isEmpty {
+      try visitor.visitSingularStringField(value: self.name, fieldNumber: 2)
+    }
+    if !self.version.isEmpty {
+      try visitor.visitSingularStringField(value: self.version, fieldNumber: 3)
+    }
+    if self.direction != .unspecified {
+      try visitor.visitSingularEnumField(value: self.direction, fieldNumber: 4)
+    }
+    try unknownFields.traverse(visitor: &visitor)
+  }
+
+  public static func ==(lhs: Pulsefield_Protocol_V1_NodeCapability, rhs: Pulsefield_Protocol_V1_NodeCapability) -> Bool {
+    if lhs.kind != rhs.kind {return false}
+    if lhs.name != rhs.name {return false}
+    if lhs.version != rhs.version {return false}
+    if lhs.direction != rhs.direction {return false}
+    if lhs.unknownFields != rhs.unknownFields {return false}
+    return true
+  }
+}
+
+nonisolated extension Pulsefield_Protocol_V1_NodeHello: SwiftProtobuf.Message, SwiftProtobuf._MessageImplementationBase, SwiftProtobuf._ProtoNameProviding {
+  public static let protoMessageName: String = _protobuf_package + ".NodeHello"
+  public static let _protobuf_nameMap = SwiftProtobuf._NameMap(bytecode: "\0\u{3}node_id\0\u{1}role\0\u{1}capabilities\0\u{3}protocol_version\0\u{3}app_id\0")
+
+  public mutating func decodeMessage<D: SwiftProtobuf.Decoder>(decoder: inout D) throws {
+    while let fieldNumber = try decoder.nextFieldNumber() {
+      // The use of inline closures is to circumvent an issue where the compiler
+      // allocates stack space for every case branch when no optimizations are
+      // enabled. https://github.com/apple/swift-protobuf/issues/1034
+      switch fieldNumber {
+      case 1: try { try decoder.decodeSingularStringField(value: &self.nodeID) }()
+      case 2: try { try decoder.decodeSingularEnumField(value: &self.role) }()
+      case 3: try { try decoder.decodeRepeatedMessageField(value: &self.capabilities) }()
+      case 4: try { try decoder.decodeSingularStringField(value: &self.protocolVersion) }()
+      case 5: try { try decoder.decodeSingularStringField(value: &self.appID) }()
+      default: break
+      }
+    }
+  }
+
+  public func traverse<V: SwiftProtobuf.Visitor>(visitor: inout V) throws {
+    if !self.nodeID.isEmpty {
+      try visitor.visitSingularStringField(value: self.nodeID, fieldNumber: 1)
+    }
+    if self.role != .unspecified {
+      try visitor.visitSingularEnumField(value: self.role, fieldNumber: 2)
+    }
+    if !self.capabilities.isEmpty {
+      try visitor.visitRepeatedMessageField(value: self.capabilities, fieldNumber: 3)
+    }
+    if !self.protocolVersion.isEmpty {
+      try visitor.visitSingularStringField(value: self.protocolVersion, fieldNumber: 4)
+    }
+    if !self.appID.isEmpty {
+      try visitor.visitSingularStringField(value: self.appID, fieldNumber: 5)
+    }
+    try unknownFields.traverse(visitor: &visitor)
+  }
+
+  public static func ==(lhs: Pulsefield_Protocol_V1_NodeHello, rhs: Pulsefield_Protocol_V1_NodeHello) -> Bool {
+    if lhs.nodeID != rhs.nodeID {return false}
+    if lhs.role != rhs.role {return false}
+    if lhs.capabilities != rhs.capabilities {return false}
+    if lhs.protocolVersion != rhs.protocolVersion {return false}
+    if lhs.appID != rhs.appID {return false}
+    if lhs.unknownFields != rhs.unknownFields {return false}
+    return true
+  }
+}