behavioralsignals 0.1.0__py3-none-any.whl

behavioralsignals/__init__.py

@@ -0,0 +1,7 @@
+from .client import Client
+from .models import StreamingOptions
+from .deepfakes import Deepfakes
+from .behavioral import Behavioral
+
+
+__all__ = ["Client", "Behavioral", "Deepfakes", "StreamingOptions"]

behavioralsignals/base.py

@@ -0,0 +1,79 @@
+from typing import Optional
+
+import grpc
+import requests
+
+from .models import APIError
+from .configuration import Configuration
+
+
+class BaseClient:
+    def __init__(self, cid: str, api_key: str):
+        self.config = Configuration(cid=cid, api_key=api_key)
+        self.session = requests.Session()
+        self._authenticate()
+
+    def _get_default_headers(self):
+        headers = {
+            "accept": "application/json",
+            "X-Auth-Token": self.config.api_key,
+        }
+        return headers
+
+    def _handle_response(self, response: requests.Response) -> dict:
+        if response.status_code != 200:
+            try:
+                error = APIError(**response.json())
+                raise Exception(f"API Error {error.code}: {error.message}")
+            except ValueError:
+                raise Exception(f"HTTP {response.status_code}: {response.text}")
+        return response.json()
+
+    def _authenticate(self):
+        headers = self._get_default_headers()
+        headers["X-Auth-Client"] = self.config.cid
+        response = self._send_request(path="auth", method="GET", headers=headers)
+        return response
+
+    def _send_request(
+        self,
+        path: str,
+        method: str = "GET",
+        data: Optional[dict] = None,
+        headers: Optional[dict] = None,
+        files: Optional[dict] = None,
+    ):
+        url = self.config.api_url + "/" + path
+        if headers is None:
+            headers = self._get_default_headers()
+
+        if method == "GET":
+            response = self.session.get(
+                url, headers=headers, params=data, timeout=self.config.timeout
+            )
+        elif method == "POST":
+            response = self.session.post(
+                url, headers=headers, data=data, files=files, timeout=self.config.timeout
+            )
+        else:
+            raise ValueError(f"Unsupported method: {method}")
+
+        return self._handle_response(response)
+
+    def close(self):
+        """Close the session."""
+        self.session.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        self.close()
+
+    def _get_channel_context(self):
+        """Returns the channel context for gRPC connections."""
+        if self.config.use_ssl:
+            credentials = grpc.ssl_channel_credentials()
+            return grpc.secure_channel(self.config.streaming_api_url, credentials=credentials)
+        else:
+            return grpc.insecure_channel(self.config.streaming_api_url)

behavioralsignals/behavioral.py

@@ -0,0 +1,151 @@
+from typing import Literal, Iterator, Optional
+from pathlib import Path
+
+from google.protobuf.json_format import MessageToDict
+
+from .base import BaseClient
+from .models import (
+    ProcessItem,
+    ResultResponse,
+    StreamingOptions,
+    AudioUploadParams,
+    ProcessListParams,
+    ProcessListResponse,
+    StreamingResultResponse,
+)
+from .generated import api_pb2 as pb
+from .generated import api_pb2_grpc as pb_grpc
+
+
+class Behavioral(BaseClient):
+    def upload_audio(
+        self,
+        file_path: str,
+        name: Optional[str] = None,
+        embeddings: bool = False,
+        meta: Optional[str] = None,
+    ) -> ProcessItem:
+        """Uploads an audio file for processing and returns the process item.
+
+        Args:
+            file_path (str): Path to the audio file to upload.
+            name (str, optional): Optional name for the job request. Defaults to filename.
+            embeddings (bool): Whether to include speaker and behavioral embeddings. Defaults to False.
+            meta (str, optional): Metadata json containing any extra user-defined metadata.
+        Returns:
+            ProcessItem: The process item containing details about the submitted process.
+        """
+        # Create and validate parameters
+        params = AudioUploadParams(file_path=file_path, name=name, embeddings=embeddings, meta=meta)
+
+        # Use provided name or default to filename
+        job_name = params.name or Path(params.file_path).name
+
+        with open(params.file_path, "rb") as audio_file:
+            files = {"file": audio_file}
+            data = {"name": job_name, "embeddings": params.embeddings}
+
+            if params.meta:
+                data["meta"] = params.meta
+
+            data = self._send_request(
+                path=f"clients/{self.config.cid}/processes/audio",
+                method="POST",
+                files=files,
+                data=data,
+            )
+
+        return ProcessItem(**data)
+
+    def list_processes(
+        self,
+        page: int = 0,
+        page_size: int = 1000,
+        sort: Literal["asc", "desc"] = "asc",
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+    ) -> ProcessListResponse:
+        """Lists all processes for the authenticated user.
+
+        Args:
+            page (int): Page number for pagination (default is 0).
+            page_size (int): Number of processes per page (default is 1000).
+            sort (str): Sort order for the processes, should be "asc" or "desc". Defaults to "asc".
+            start_date (str, optional: Filter processes created on or after this date (YYYY-MM-DD).
+            end_date (str, optional): Filter processes created on or before this date (YYYY-MM-DD).
+        Returns:
+            ProcessListResponse: A list of processes associated with the user.
+        """
+
+        query_params = ProcessListParams(
+            page=page, page_size=page_size, sort=sort, start_date=start_date, end_date=end_date
+        )
+        query_params = query_params.model_dump(by_alias=True, exclude_none=True)
+
+        data = self._send_request(
+            path=f"clients/{self.config.cid}/processes",
+            method="GET",
+            data=query_params,
+        )
+
+        return ProcessListResponse(processes=data)
+
+    def get_process(self, pid: int) -> ProcessItem:
+        """Retrieves details of a specific process by its ID.
+
+        Args:
+            pid (int): The process ID to retrieve.
+        Returns:
+            ProcessItem: The process item containing details about the specified process.
+        """
+
+        data = self._send_request(
+            path=f"clients/{self.config.cid}/processes/{pid}",
+            method="GET",
+        )
+
+        return ProcessItem(**data)
+
+    def get_result(self, pid: int) -> ResultResponse:
+        """Retrieves the result of a completed process by its ID.
+
+        Args:
+            pid (int): The process ID for which to retrieve the result
+        Returns:
+            ResultResponse: The result response containing the results of the specified process.
+        """
+        data = self._send_request(
+            path=f"clients/{self.config.cid}/processes/{pid}/results",
+            method="GET",
+        )
+        return ResultResponse(**data)
+
+    def stream_audio(
+        self, audio_stream: Iterator[bytes], options: StreamingOptions
+    ) -> Iterator[ResultResponse]:
+        with self._get_channel_context() as channel:
+            stub = pb_grpc.BehavioralStreamingApiStub(channel)
+
+            def _request_generator() -> Iterator[pb.AudioStream]:
+                # Streaming API always requires the first message to contain
+                # the audio configurationand authentication details
+                audio_config = options.to_pb_config()
+                req = pb.AudioStream(
+                    cid=int(self.config.cid),
+                    x_auth_token=self.config.api_key,
+                    config=audio_config,
+                )
+                yield req
+
+                for chunk in audio_stream:
+                    yield pb.AudioStream(
+                        cid=int(self.config.cid),
+                        x_auth_token=self.config.api_key,
+                        audio_content=chunk,
+                    )
+
+            response_stream = stub.StreamAudio(_request_generator())
+            for response in response_stream:
+                resp_dict = MessageToDict(response, always_print_fields_with_no_presence=True)
+                response_data = StreamingResultResponse(**resp_dict)
+                yield response_data

behavioralsignals/client.py

@@ -0,0 +1,22 @@
+import importlib
+
+from .base import BaseClient
+
+
+client_map = {
+    "behavioral": ("behavioralsignals.behavioral", "Behavioral"),
+    "deepfakes": ("behavioralsignals.deepfakes", "Deepfakes"),
+}
+
+
+class Client(BaseClient):
+    def __getattr__(self, name):
+        if name in client_map:
+            module_path, class_name = client_map[name]
+            module = importlib.import_module(module_path)
+            client_class = getattr(module, class_name)
+            instance = client_class(cid=self.config.cid, api_key=self.config.api_key)
+            setattr(self, name, instance)
+            return instance
+
+        raise AttributeError(f"'{self.__class__.__name__}' object has no attribute '{name}'")

behavioralsignals/configuration.py

@@ -0,0 +1,24 @@
+from typing import Union, Optional
+
+from pydantic import field_validator
+from pydantic.dataclasses import dataclass
+
+
+TimeoutType = Union[float, tuple[float, float]]
+
+
+@dataclass
+class Configuration:
+    cid: Union[str, int]
+    api_key: str
+    api_url: str = "https://api.behavioralsignals.com/v5"
+    streaming_api_url: str = "streaming.behavioralsignals.com:443"
+    timeout: Optional[TimeoutType] = None
+    use_ssl: bool = True
+
+    @field_validator("cid", mode="before")
+    @classmethod
+    def convert_cid(cls, v):
+        if not isinstance(v, (str, int)):
+            raise TypeError(f"cid must be str or int, got {type(v).__name__}")
+        return str(v)

behavioralsignals/deepfakes.py

@@ -0,0 +1,151 @@
+from typing import Literal, Iterator, Optional
+from pathlib import Path
+
+from google.protobuf.json_format import MessageToDict
+
+from .base import BaseClient
+from .models import (
+    ProcessItem,
+    ResultResponse,
+    StreamingOptions,
+    AudioUploadParams,
+    ProcessListParams,
+    ProcessListResponse,
+    StreamingResultResponse,
+)
+from .generated import api_pb2 as pb
+from .generated import api_pb2_grpc as pb_grpc
+
+
+class Deepfakes(BaseClient):
+    def upload_audio(
+        self,
+        file_path: str,
+        name: Optional[str] = None,
+        embeddings: bool = False,
+        meta: Optional[str] = None,
+    ) -> ProcessItem:
+        """Uploads an audio file for processing and returns the process item.
+
+        Args:
+            file_path (str): Path to the audio file to upload.
+            name (str, optional): Optional name for the job request. Defaults to filename.
+            embeddings (bool): Whether to include speaker and behavioral embeddings. Defaults to False.
+            meta (str, optional): Metadata json containing any extra user-defined metadata.
+        Returns:
+            ProcessItem: The process item containing details about the submitted process.
+        """
+        # Create and validate parameters
+        params = AudioUploadParams(file_path=file_path, name=name, embeddings=embeddings, meta=meta)
+
+        # Use provided name or default to filename
+        job_name = params.name or Path(params.file_path).name
+
+        with open(params.file_path, "rb") as audio_file:
+            files = {"file": audio_file}
+            data = {"name": job_name, "embeddings": params.embeddings}
+
+            if params.meta:
+                data["meta"] = params.meta
+
+            data = self._send_request(
+                path=f"detection/clients/{self.config.cid}/processes/audio",
+                method="POST",
+                files=files,
+                data=data,
+            )
+
+        return ProcessItem(**data)
+
+    def list_processes(
+        self,
+        page: int = 0,
+        page_size: int = 1000,
+        sort: Literal["asc", "desc"] = "asc",
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+    ) -> ProcessListResponse:
+        """Lists all processes for the authenticated user.
+
+        Args:
+            page (int): Page number for pagination (default is 0).
+            page_size (int): Number of processes per page (default is 1000).
+            sort (str): Sort order for the processes, should be "asc" or "desc". Defaults to "asc".
+            start_date (str, optional: Filter processes created on or after this date (YYYY-MM-DD).
+            end_date (str, optional): Filter processes created on or before this date (YYYY-MM-DD).
+        Returns:
+            ProcessListResponse: A list of processes associated with the user.
+        """
+
+        query_params = ProcessListParams(
+            page=page, page_size=page_size, sort=sort, start_date=start_date, end_date=end_date
+        )
+        query_params = query_params.model_dump(by_alias=True, exclude_none=True)
+
+        data = self._send_request(
+            path=f"detection/clients/{self.config.cid}/processes",
+            method="GET",
+            data=query_params,
+        )
+
+        return ProcessListResponse(processes=data)
+
+    def get_process(self, pid: int) -> ProcessItem:
+        """Retrieves details of a specific process by its ID.
+
+        Args:
+            pid (int): The process ID to retrieve.
+        Returns:
+            ProcessItem: The process item containing details about the specified process.
+        """
+
+        data = self._send_request(
+            path=f"detection/clients/{self.config.cid}/processes/{pid}",
+            method="GET",
+        )
+
+        return ProcessItem(**data)
+
+    def get_result(self, pid: int) -> ResultResponse:
+        """Retrieves the result of a completed process by its ID.
+
+        Args:
+            pid (int): The process ID for which to retrieve the result
+        Returns:
+            ResultResponse: The result response containing the results of the specified process.
+        """
+        data = self._send_request(
+            path=f"detection/clients/{self.config.cid}/processes/{pid}/results",
+            method="GET",
+        )
+        return ResultResponse(**data)
+
+    def stream_audio(
+        self, audio_stream: Iterator[bytes], options: StreamingOptions
+    ) -> Iterator[ResultResponse]:
+        with self._get_channel_context() as channel:
+            stub = pb_grpc.BehavioralStreamingApiStub(channel)
+
+            def _request_generator() -> Iterator[pb.AudioStream]:
+                # Streaming API always requires the first message to contain
+                # the audio configurationand authentication details
+                audio_config = options.to_pb_config()
+                req = pb.AudioStream(
+                    cid=int(self.config.cid),
+                    x_auth_token=self.config.api_key,
+                    config=audio_config,
+                )
+                yield req
+
+                for chunk in audio_stream:
+                    yield pb.AudioStream(
+                        cid=int(self.config.cid),
+                        x_auth_token=self.config.api_key,
+                        audio_content=chunk,
+                    )
+
+            response_stream = stub.DeepfakeDetection(_request_generator())
+            for response in response_stream:
+                resp_dict = MessageToDict(response, always_print_fields_with_no_presence=True)
+                response_data = StreamingResultResponse(**resp_dict)
+                yield response_data

behavioralsignals/generated/api_pb2.py

@@ -0,0 +1,50 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: api.proto
+# Protobuf Python Version: 6.31.0
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    0,
+    '',
+    'api.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\tapi.proto\x12\x16\x62\x65havioral_api.grpc.v1\"\xf4\x01\n\x0b\x41udioConfig\x12\x37\n\x08\x65ncoding\x18\x01 \x01(\x0e\x32%.behavioral_api.grpc.v1.AudioEncoding\x12\x19\n\x11sample_rate_hertz\x18\x02 \x01(\x05\x12\x31\n\x05level\x18\x03 \x01(\x0e\x32\x1d.behavioral_api.grpc.v1.LevelH\x00\x88\x01\x01\x12\x13\n\x06logits\x18\x04 \x01(\x08H\x01\x88\x01\x01\x12\x1e\n\x11\x66\x65\x61ture_embedding\x18\x05 \x01(\x08H\x02\x88\x01\x01\x42\x08\n\x06_levelB\t\n\x07_logitsB\x14\n\x12_feature_embedding\"|\n\x0b\x41udioStream\x12\x0b\n\x03\x63id\x18\x01 \x01(\x03\x12\x14\n\x0cx_auth_token\x18\x02 \x01(\t\x12\x33\n\x06\x63onfig\x18\x03 \x01(\x0b\x32#.behavioral_api.grpc.v1.AudioConfig\x12\x15\n\raudio_content\x18\x04 \x01(\x0c\"_\n\nPrediction\x12\r\n\x05label\x18\x01 \x01(\t\x12\x16\n\tposterior\x18\x02 \x01(\tH\x00\x88\x01\x01\x12\x12\n\x05logit\x18\x03 \x01(\tH\x01\x88\x01\x01\x42\x0c\n\n_posteriorB\x08\n\x06_logit\"\x81\x02\n\x0fInferenceResult\x12\n\n\x02id\x18\x01 \x01(\t\x12\x12\n\nstart_time\x18\x02 \x01(\t\x12\x10\n\x08\x65nd_time\x18\x03 \x01(\t\x12\x0c\n\x04task\x18\x04 \x01(\t\x12\x36\n\nprediction\x18\x05 \x03(\x0b\x32\".behavioral_api.grpc.v1.Prediction\x12\x13\n\x0b\x66inal_label\x18\x06 \x01(\t\x12\x16\n\tembedding\x18\x07 \x01(\tH\x00\x88\x01\x01\x12\x31\n\x05level\x18\x08 \x01(\x0e\x32\x1d.behavioral_api.grpc.v1.LevelH\x01\x88\x01\x01\x42\x0c\n\n_embeddingB\x08\n\x06_level\"u\n\x0cStreamResult\x12\x0b\n\x03\x63id\x18\x01 \x01(\x03\x12\x0b\n\x03pid\x18\x02 \x01(\x03\x12\x12\n\nmessage_id\x18\x03 \x01(\x05\x12\x37\n\x06result\x18\x04 \x03(\x0b\x32\'.behavioral_api.grpc.v1.InferenceResult*\x1f\n\rAudioEncoding\x12\x0e\n\nLINEAR_PCM\x10\x00*#\n\x05Level\x12\x0b\n\x07segment\x10\x00\x12\r\n\tutterance\x10\x01\x32\xde\x01\n\x16\x42\x65havioralStreamingApi\x12^\n\x0bStreamAudio\x12#.behavioral_api.grpc.v1.AudioStream\x1a$.behavioral_api.grpc.v1.StreamResult\"\x00(\x01\x30\x01\x12\x64\n\x11\x44\x65\x65pfakeDetection\x12#.behavioral_api.grpc.v1.AudioStream\x1a$.behavioral_api.grpc.v1.StreamResult\"\x00(\x01\x30\x01\x62\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'api_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_AUDIOENCODING']._serialized_start=886
+  _globals['_AUDIOENCODING']._serialized_end=917
+  _globals['_LEVEL']._serialized_start=919
+  _globals['_LEVEL']._serialized_end=954
+  _globals['_AUDIOCONFIG']._serialized_start=38
+  _globals['_AUDIOCONFIG']._serialized_end=282
+  _globals['_AUDIOSTREAM']._serialized_start=284
+  _globals['_AUDIOSTREAM']._serialized_end=408
+  _globals['_PREDICTION']._serialized_start=410
+  _globals['_PREDICTION']._serialized_end=505
+  _globals['_INFERENCERESULT']._serialized_start=508
+  _globals['_INFERENCERESULT']._serialized_end=765
+  _globals['_STREAMRESULT']._serialized_start=767
+  _globals['_STREAMRESULT']._serialized_end=884
+  _globals['_BEHAVIORALSTREAMINGAPI']._serialized_start=957
+  _globals['_BEHAVIORALSTREAMINGAPI']._serialized_end=1179
+# @@protoc_insertion_point(module_scope)

behavioralsignals/generated/api_pb2.pyi

@@ -0,0 +1,88 @@
+from google.protobuf.internal import containers as _containers
+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 collections.abc import Iterable as _Iterable, Mapping as _Mapping
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class AudioEncoding(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+    __slots__ = ()
+    LINEAR_PCM: _ClassVar[AudioEncoding]
+
+class Level(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+    __slots__ = ()
+    segment: _ClassVar[Level]
+    utterance: _ClassVar[Level]
+LINEAR_PCM: AudioEncoding
+segment: Level
+utterance: Level
+
+class AudioConfig(_message.Message):
+    __slots__ = ("encoding", "sample_rate_hertz", "level", "logits", "feature_embedding")
+    ENCODING_FIELD_NUMBER: _ClassVar[int]
+    SAMPLE_RATE_HERTZ_FIELD_NUMBER: _ClassVar[int]
+    LEVEL_FIELD_NUMBER: _ClassVar[int]
+    LOGITS_FIELD_NUMBER: _ClassVar[int]
+    FEATURE_EMBEDDING_FIELD_NUMBER: _ClassVar[int]
+    encoding: AudioEncoding
+    sample_rate_hertz: int
+    level: Level
+    logits: bool
+    feature_embedding: bool
+    def __init__(self, encoding: _Optional[_Union[AudioEncoding, str]] = ..., sample_rate_hertz: _Optional[int] = ..., level: _Optional[_Union[Level, str]] = ..., logits: bool = ..., feature_embedding: bool = ...) -> None: ...
+
+class AudioStream(_message.Message):
+    __slots__ = ("cid", "x_auth_token", "config", "audio_content")
+    CID_FIELD_NUMBER: _ClassVar[int]
+    X_AUTH_TOKEN_FIELD_NUMBER: _ClassVar[int]
+    CONFIG_FIELD_NUMBER: _ClassVar[int]
+    AUDIO_CONTENT_FIELD_NUMBER: _ClassVar[int]
+    cid: int
+    x_auth_token: str
+    config: AudioConfig
+    audio_content: bytes
+    def __init__(self, cid: _Optional[int] = ..., x_auth_token: _Optional[str] = ..., config: _Optional[_Union[AudioConfig, _Mapping]] = ..., audio_content: _Optional[bytes] = ...) -> None: ...
+
+class Prediction(_message.Message):
+    __slots__ = ("label", "posterior", "logit")
+    LABEL_FIELD_NUMBER: _ClassVar[int]
+    POSTERIOR_FIELD_NUMBER: _ClassVar[int]
+    LOGIT_FIELD_NUMBER: _ClassVar[int]
+    label: str
+    posterior: str
+    logit: str
+    def __init__(self, label: _Optional[str] = ..., posterior: _Optional[str] = ..., logit: _Optional[str] = ...) -> None: ...
+
+class InferenceResult(_message.Message):
+    __slots__ = ("id", "start_time", "end_time", "task", "prediction", "final_label", "embedding", "level")
+    ID_FIELD_NUMBER: _ClassVar[int]
+    START_TIME_FIELD_NUMBER: _ClassVar[int]
+    END_TIME_FIELD_NUMBER: _ClassVar[int]
+    TASK_FIELD_NUMBER: _ClassVar[int]
+    PREDICTION_FIELD_NUMBER: _ClassVar[int]
+    FINAL_LABEL_FIELD_NUMBER: _ClassVar[int]
+    EMBEDDING_FIELD_NUMBER: _ClassVar[int]
+    LEVEL_FIELD_NUMBER: _ClassVar[int]
+    id: str
+    start_time: str
+    end_time: str
+    task: str
+    prediction: _containers.RepeatedCompositeFieldContainer[Prediction]
+    final_label: str
+    embedding: str
+    level: Level
+    def __init__(self, id: _Optional[str] = ..., start_time: _Optional[str] = ..., end_time: _Optional[str] = ..., task: _Optional[str] = ..., prediction: _Optional[_Iterable[_Union[Prediction, _Mapping]]] = ..., final_label: _Optional[str] = ..., embedding: _Optional[str] = ..., level: _Optional[_Union[Level, str]] = ...) -> None: ...
+
+class StreamResult(_message.Message):
+    __slots__ = ("cid", "pid", "message_id", "result")
+    CID_FIELD_NUMBER: _ClassVar[int]
+    PID_FIELD_NUMBER: _ClassVar[int]
+    MESSAGE_ID_FIELD_NUMBER: _ClassVar[int]
+    RESULT_FIELD_NUMBER: _ClassVar[int]
+    cid: int
+    pid: int
+    message_id: int
+    result: _containers.RepeatedCompositeFieldContainer[InferenceResult]
+    def __init__(self, cid: _Optional[int] = ..., pid: _Optional[int] = ..., message_id: _Optional[int] = ..., result: _Optional[_Iterable[_Union[InferenceResult, _Mapping]]] = ...) -> None: ...