runanywhere_protos library

Public generated proto type surface for RunAnywhere Flutter.

Import this library with a prefix when an app needs canonical IDL types alongside the Flutter facade:

import 'package:runanywhere/runanywhere_protos.dart' as ra_proto;

Classes

AccelerationPreference
AcceleratorInfo
AgentLoopConfig
AgentResponseCompletedEvent
AgentResponseStartedEvent
AppStorageInfo
ArchiveArtifact
ArchiveStructure
ArchiveType
ArtifactInferFromUrlRequest
ArtifactInferFromUrlResult
AssistantTokenEvent
Single token decoded by the LLM. is_final=true on the last token of a response (end-of-stream marker).
AudioEncoding
AudioFormat
AudioFrameEvent
A chunk of synthesized PCM audio, ready for the sink. The frontend is expected to copy the bytes out; the C ABI does NOT retain ownership.
AudioLevelEvent
AudioPipelineConfig
AudioSource
AuthEvent
AuthEventKind
BatteryFilter
CancellationEvent
CancellationEventKind
CapabilityOperationEvent
=========================================================================== SECTION 6 — EMBEDDINGS / SECTION 7 — DIFFUSION / SECTION 8 — RAG / SECTION 9 — LORA / SECTION 2b — VLM (capability operations)
CapabilityOperationEventKind
ChatApi
Logical chat service contract. Host conversation state, UI rendering, and backend execution remain adapter-owned; this service describes only the portable Generate / Stream entry points over generated messages.
ChatAttachment
ChatConversationState
ChatGenerationRequest
ChatGenerationResult
ChatMessage
ChatMessageStatus
ChatStreamEvent
ChatStreamEventKind
ClassificationCandidate
ClassificationResult
CloudSttBackendConfig
ComponentInitializationEvent
ComponentInitializationEventKind
ComponentLifecycleEvent
Operation-aware lifecycle event. The oneof arms intentionally reference the operation result/progress protos from this contract slice instead of adding another broad event taxonomy.
ComponentLifecycleSnapshot
Snapshot of a component's current model-backed lifecycle state.
ComponentLifecycleSnapshotRequest
ComponentLifecycleSnapshotResult
ComponentLifecycleState
Component runtime lifecycle state for model-backed SDK components. Platform adapters own native component handles; this enum carries the C++ lifecycle state every SDK can expose uniformly. Previously lived in sdk_events.proto (also used by voice_events.proto's VoiceAgentComponentStates after the former hand-rolled ComponentLoadState was consolidated into this single richer taxonomy).
ComponentProgressEvent
ConfidenceCascade
ConfigurationEvent
ConfigurationEventKind
CurrentModelRequest
CurrentModelResult
CustomFilter
DeviceAffinity
DeviceEvent
DeviceEventKind
DeviceStorageInfo
DiffusionApi
Logical Diffusion service contract. Native photo-library/camera/file acquisition, OS-visible image operations, and platform-specific backend execution remain adapter-owned; C++ consumes only serialized request/result/event messages.
DiffusionCapabilities
DiffusionConfig
DiffusionConfiguration
DiffusionGenerationOptions
DiffusionGenerationRequest
DiffusionMode
DiffusionModelVariant
DiffusionProgress
DiffusionResult
DiffusionScheduler
DiffusionServiceState
DiffusionStreamEvent
DiffusionStreamEventKind
DiffusionTokenizerSource
DiffusionTokenizerSourceKind
DiscoveredModel
DownloadApi
DownloadCancelRequest
DownloadCancelResult
DownloadEvent
DownloadEventKind
DownloadFailureReason
Structured reason for a download plan/start/resume rejection. Lets every SDK branch on a stable enum instead of substring-matching the human-readable error_message (the prior approach, which silently broke on any reword).
DownloadFilePlan
DownloadPlanRequest
DownloadPlanResult
DownloadProgress
DownloadResumeRequest
DownloadResumeResult
DownloadStage
DownloadStartRequest
DownloadStartResult
DownloadState
DownloadSubscribeRequest
EdgePolicy
EdgeSpec
EmbeddingsApi
Logical Embeddings service contract. Tokenizer/model execution and native file handles remain adapter/backend-owned; C++ consumes only serialized request/result messages.
EmbeddingsConfiguration
EmbeddingsCreateRequest
EmbeddingsCreateResult
EmbeddingsNormalizeMode
EmbeddingsOptions
EmbeddingsPoolingStrategy
EmbeddingsRequest
EmbeddingsResult
EmbeddingsServiceState
EmbeddingVector
EntityExtractionResult
ErrorCategory
ErrorCode
ErrorContext
ErrorEvent
Terminal or recoverable error in the pipeline. Frontends map these to their native error types.
ErrorSeverity
EventCategory
Canonical event category carried by every SDKEvent envelope. Lives here (instead of sdk_events.proto) so voice_events.proto and voice_agent_service .proto can reference it without importing sdk_events.proto (which itself imports voice_events.proto — cycle resolution).
EventDestination
ExecutionTarget
ExpectedModelFiles
FailureEvent
FrameworkEvent
FrameworkEventKind
FrameworksForCapabilityRequest
FrameworksForCapabilityResponse
GenerationEvent
GenerationEventKind
GenerationHints
HardwareAcceleratorPreferenceRequest
Result-shaped response for SetAcceleratorPreference so the service contract stays consistent (every rpc returns a non-empty message).
HardwareAcceleratorPreferenceResult
HardwareAcceleratorsRequest
Empty request for the accelerator list. Mirrors HardwareProfileRequest: platform probes own all OS-level acceleration discovery.
HardwareApi
HardwareProfile
HardwareProfileRequest
Empty request for the cached hardware profile. The native probe is owned by platform adapters; this request carries no portable parameters today.
HardwareProfileResult
HardwareRoutingEvent
HardwareRoutingEventKind
HexagonArch
Logical hardware service contract. Mirrors the C ABI in sdk/runanywhere-commons/include/rac/router/rac_hardware_abi.h:
HttpDownloadStatus
HTTP transport download status — numeric values MUST match rac_http_download_status_t (RAC_HTTP_DL_) in sdk/runanywhere-commons/include/rac/infrastructure/http/rac_http_download.h. rac_http_download_execute returns this int directly through the C ABI; every SDK consumes the proto-generated enum so a new RAC_HTTP_DL_ value added in commons fails compilation across all bindings until the enum is extended here. OK = 0 mirrors the C ABI's success sentinel (no separate UNSPECIFIED needed — success is the proto3 zero default).
HybridBackendKind
HybridCapability
HybridCascade
HybridFilter
HybridModelDescriptor
HybridModelType
HybridRank
HybridRoutedMetadata
HybridRoutingContext
HybridRoutingPolicy
HybridSttTranscribeOptions
HybridSttTranscribeRequest
HybridSttTranscribeResponse
InferenceFramework
InitializationEvent
InitializationStage
InterruptedEvent
Assistant playback was interrupted by a barge-in. The reason distinguishes user barge-in from app-initiated cancel.
InterruptReason
JSONSchema
JSONSchemaProperty
JSONSchemaType
LifecycleApi
Logical model-lifecycle service contract. Mirrors the C ABI entry points rac_model_lifecycle_load_proto, rac_model_lifecycle_unload_proto, rac_model_lifecycle_current_model_proto, and rac_component_lifecycle_snapshot_proto. Platform adapters remain responsible for native filesystem permissions, sandbox/bookmark/SAF handles, and OS-level process lifecycle; this service carries only the portable load/unload/current/snapshot contracts owned by C++.
LLMApi
LLMConfiguration
LLMGenerateRequest
Generation settings live exclusively in options. Reserved field numbers prevent unsafe wire reuse.
LLMGenerationOptions
LLMGenerationRequest
Request envelope for one non-streaming LLM generation call. This is the proto-owned DTO SDKs can use instead of parallel prompt/options tuples.
LLMGenerationResult
LLMGenerationState
LLMGenerationStatus
LLMStreamEvent
Unified per-token streaming event. Replaces LLMToken (deleted) and the per-SDK hand-rolled AsyncThrowingStream / callbackFlow / StreamController / tokenQueue. One serialized event per generated token. Mirrors VoiceEvent's seq + timestamp_us pattern from voice_events.proto so frontends can reuse gap-detection logic.
LLMStreamEventKind
LLMStreamFinalResult
Aggregate terminal payload emitted by LLMStreamEvent. It intentionally keeps stream-native token, timing, and error fields distinct from the unary LLMGenerationResult shape.
LogEntry
LoggingConfiguration
LogLevel
LoraAdapterCatalogEntry
LoraAdapterCatalogGetRequest
LoraAdapterCatalogGetResult
LoraAdapterCatalogListRequest
LoraAdapterCatalogListResult
LoraAdapterCatalogQuery
LoRAAdapterConfig
LoraAdapterDownloadCompletedRequest
LoraAdapterDownloadCompletedResult
LoraAdapterImportRequest
LoraAdapterImportResult
LoRAAdapterInfo
LoRAApi
Logical LoRA service contract. Adapter file acquisition, sandbox handles, and backend-specific load/unload execution remain adapter/backend-owned; C++ consumes only serialized request/result/state messages.
LoRAApplyRequest
LoRAApplyResult
LoraCompatibilityResult
LoRARemoveRequest
LoRAState
MessageRole
MetricsEvent
Per-primitive latency breakdown. Emitted at barge-in and at pipeline stop.
ModelArtifactType
ModelCategory
ModelCompatibilityRequest
ModelCompatibilityResult
ModelDeleteRequest
ModelDeleteResult
ModelDiscoveryRequest
ModelDiscoveryResult
ModelEvent
ModelEventKind
ModelFileDescriptor
ModelFileRole
Role of a file inside a single/multi-file artifact. The generic COMPANION role covers arbitrary sidecars; specific roles document common public catalog files such as VLM mmproj files and tokenizer/config assets.
ModelFormat
ModelFormatFromUrlRequest
ModelFormatFromUrlResult
ModelGetRequest
ModelGetResult
ModelImportRequest
ModelImportResult
ModelInfo
ModelInfoList
Repeated model registry responses use this wrapper because protobuf cannot serialize a bare repeated field as a top-level message.
ModelInfoMakeRequest
ModelInfoMetadata
ModelListRequest
ModelListResult
ModelLoadRequest
ModelLoadResult
ModelQuery
Registry/query filters shared by SDK model-management APIs. UI-only presentation state and platform filesystem handles are intentionally not represented here.
ModelQuerySortField
ModelQuerySortOrder
ModelRegistryApi
Logical ModelRegistry service contract. Platform adapters remain responsible for native file handles, sandbox permissions, HTTP execution, and destructive filesystem operations. This service carries only the portable registry metadata and workflow messages owned by the IDL/C++ layer.
ModelRegistryEvent
ModelRegistryEventKind
ModelRegistryFetchAssignmentsRequest
ModelRegistryFetchAssignmentsResult
ModelRegistryRefreshRequest
ModelRegistryRefreshResult
ModelRegistryStatus
ModelRuntimeCompatibility
ModelSource
ModelStorageMetrics
ModelUnloadRequest
ModelUnloadResult
MultiFileArtifact
NamedEntity
NERResult
NetworkEvent
NetworkEventKind
NpuCapability
NPUChip
NpuProbeRequest
Empty request for the NPU probe; mirrors HardwareProfileRequest.
OperatorSpec
PerformanceEvent
PerformanceEventKind
PerformanceMetrics
PipelineApi
Logical pipeline service contract. Frontends pass a PipelineSpec, receive a compiled-graph handle, then start and stop the live instance. Backend execution, native runtime scheduling, and side effects remain adapter-owned.
PipelineCompileResult
Result of compiling a PipelineSpec into a runnable graph.
PipelineHandle
Live pipeline instance handle.
PipelineOptions
PipelineSpec
A pipeline is a labelled DAG of operators connected by typed edges. There are no cycles. Every input edge has a resolvable producer; every output edge has at least one consumer.
PipelineStartRequest
Request to start a previously compiled pipeline.
PipelineState
PipelineStatus
PipelineStopResult
Result of stopping a pipeline instance.
PluginInfo
A loaded/registered plugin. path is empty for plugins the native registry reports by name only (it does not persist load paths) — proto3 string default "" matches the current path: "" placeholder.
PluginInfoList
Result of the plugin-list bridge calls (registeredNames / listLoaded).
Rac_options
RAGApi
Logical RAG service contract. Native file pickers, sandbox handles, browser File System Access handles, and backend execution remain adapter-owned; C++ consumes only serialized configuration/request/result/state/event messages.
RAGConfig
RAGConfiguration
RAGDocument
RAGIngestRequest
RAGIngestResult
RAGQueryOptions
RAGQueryRequest
RAGResult
RAGSearchResult
RAGServiceState
RAGStatistics
RAGStreamEvent
RAGStreamEventKind
RegisterModelFromUrlRequest
RegisterMultiFileModelRequest
RoutingPolicy
SDKComponent
SDKEnvironment
SDKError
SDKEvent
SDKEventFilter
Subscription-side filter for the canonical SDKEvent stream. Empty fields are wildcards; implementations match populated fields against the envelope fields above without interpreting payload-specific data.
SDKEventPublishRequest
SDKEventPublishResult
SDKEventsApi
Logical SDK event service contract. C++ owns event envelope normalization, routing/subscription matching, correlation/operation/source/trace metadata, and the serialized-proto bridge. Platform adapters own OS notification APIs, lifecycle callbacks, permission prompts, and host event-loop integration.
SDKEventSubscribeRequest
SdkInitEnvironment
SdkInitPhase
SdkInitPhase1Request
SdkInitPhase2Request
SdkInitResult
Sentiment
SentimentResult
SessionEvent
SDK session lifecycle independent of voice-agent turn sessions.
SessionEventKind
SessionStartedEvent
SessionStoppedEvent
SingleFileArtifact
SolutionConfig
Top-level union dispatched to the matching solution loader.
SolutionHandle
SolutionsApi
Logical solutions service contract. Solution lifecycle verbs (create/start/ stop/destroy) mirror the rac_solution_handle_t C ABI. Host UI, progress surfacing, and side effects remain adapter-owned; this service describes only the portable ergonomic entry points over generated messages.
SolutionType
SpeechActivityEvent
SpeechActivityKind
SpeechTurnDetectionEvent
SpeechTurnDetectionEventKind
StateChangeEvent
Pipeline lifecycle state. Ordered — callers can compare numerically.
StorageApi
Logical Storage service contract. Platform adapters remain responsible for directory resolution, sandbox/bookmark/SAF/File System Access handles, OS free-space facts, permissions, and destructive file operations that require platform participation. C++ consumes only serialized request/result messages for metadata aggregation, availability checks, safe delete planning, and scoped delete execution.
StorageAvailability
StorageAvailabilityRequest
StorageAvailabilityResult
StorageDeleteCandidate
StorageDeletePlan
StorageDeletePlanRequest
StorageDeleteRequest
StorageDeleteResult
StorageEvent
StorageEventKind
StorageInfo
StorageInfoRequest
StorageInfoResult
StorageLifecycleEvent
StorageLifecycleEventKind
StreamToken
StructuredOutputApi
Logical structured-output service contract. Model execution, retries, UI callbacks, and platform-specific JSON parser choices remain adapter-owned; this service describes portable prompt preparation, extraction/parsing, and validation semantics over generated messages.
StructuredOutputMode
StructuredOutputOptions
StructuredOutputParseRequest
StructuredOutputPromptResult
StructuredOutputRequest
StructuredOutputResult
StructuredOutputStreamEvent
StructuredOutputStreamEventKind
StructuredOutputValidation
StructuredOutputValidationRequest
STTApi
Logical STT service contract. Platform adapters remain responsible for native capture, file access, and stream plumbing; C++ consumes only the serialized request/event messages defined above.
STTAudioEncoding
STTAudioSource
STTConfiguration
STTLanguage
STTLanguageDetectionResult
STTOptions
STTOutput
STTPartialResult
STTServiceState
STTStreamEvent
STTStreamEventKind
STTTranscriptionRequest
TelemetryEvent
TelemetryEventKind
ThinkingTagPattern
TimeSeriesConfig
TokenKind
ToolCall
ToolCallFormatName
ToolCallingApi
Logical tool-calling service contract. Host tool registration, permission checks, execution, callbacks, browser/native APIs, and side effects remain adapter-owned; this service describes only portable parsing, prompt formatting, and validation semantics over generated messages.
ToolCallingOptions
ToolCallingResult
ToolCallingSessionCreateRequest
ToolCallingSessionCreateResult
ToolCallingSessionDestroyRequest
ToolCallingSessionEvent
ToolCallingSessionStepWithResultRequest
ToolCallingStreamEvent
ToolCallingStreamEventKind
ToolCallValidationRequest
ToolCallValidationResult
ToolChoiceMode
ToolDefinition
ToolParameter
ToolParameterType
ToolParseRequest
ToolParseResult
ToolPromptFormatRequest
ToolPromptFormatResult
ToolRegistrySnapshot
ToolResult
ToolSpec
ToolValue
ToolValueArray
ToolValueJSON
ToolValueObject
TranscriptionAlternative
TranscriptionMetadata
TTSApi
Logical TTS service contract. Native playback, audio-session ownership, device routing, and OS TTS sessions remain platform-owned; C++ consumes only the serialized request/result/event messages defined above.
TTSConfiguration
TTSOptions
TTSOutput
TTSPhonemeTimestamp
TTSServiceState
TTSSpeakResult
TTSStreamEvent
TTSStreamEventKind
TTSSynthesisMetadata
TTSSynthesisRequest
TTSVoiceGender
TTSVoiceInfo
TTSVoiceList
Wire envelope returned by rac_tts_list_voices_lifecycle_proto. Replaces the per-voice callback pattern used by the legacy handle-based ABI so the lifecycle-driven listing call returns a single serialized message.
TurnLifecycleEvent
TurnLifecycleEventKind
UserSaidEvent
User speech finalized by STT (is_final=false → partial hypothesis).
VADApi
Logical VAD service contract. Native microphone capture, audio-session ownership, device routing, and platform stream plumbing remain outside C++; C++ consumes only serialized frame requests and emits logical VAD events.
VADAudioEncoding
VADAudioSource
VADConfiguration
VADEvent
Voice Activity Detection output. Frontends usually do not need this — exposed for debugging and custom UIs (waveform highlighting, etc.). type uses the canonical VADStreamEventKind enum from vad_options.proto (the hand-rolled VADEventType was deleted).
VADOptions
VADProcessRequest
VADResult
VADServiceState
VADStatistics
VADStreamEvent
VADStreamEventKind
VectorStore
VLMApi
Logical VLM service contract. Native camera capture, file picking, image decoding performed by OS media APIs, and backend execution remain adapter-owned; C++ consumes only serialized request/result/event messages.
VLMChatTemplate
VLMConfiguration
VLMGenerationOptions
VLMGenerationRequest
VLMImage
VLMImageFormat
VLMModelFamily
VLMResult
VLMServiceState
VLMStreamEvent
VLMStreamEventKind
VoiceAgentApi
VoiceAgentComponentStates
Aggregate load state across all four voice-agent components. Mirrors Swift VoiceAgentComponentStates, Kotlin VoiceAgentComponentStates, RN VoiceAgentComponentStates, Web VoiceAgentComponentStates, and Flutter VoiceAgentComponentStates.
VoiceAgentComposeConfig
VoiceAgentConfig
VoiceAgentRequest
Empty request type — the voice agent already has its config set via rac_voice_agent_init() at handle creation time. The Stream rpc just opens a new event subscription on an existing handle.
VoiceAgentResult
VoiceAgentSynthesizeSpeechProtoRequest
VoiceAgentTranscribeProtoRequest
Helper-level proto requests for voice-agent sub-components.
VoiceAgentTurnRequest
VoiceEvent
VoiceEventKind
VoiceLifecycleEvent
VoicePipelineComponent
VoiceSessionConfig
VoiceSessionError
WakeWordDetectedEvent
WordTimestamp

Extensions

GeneratedMessageGenericExtensions on T
Extensions on GeneratedMessages.