runanywhere library

RunAnywhere Flutter SDK - Core Package.

The generated protobuf modules are the canonical data-contract surface. Hand-written exports below are limited to platform glue, capability facades, and Dart helpers that expose real SDK behavior.

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).
AudioCaptureManager
SDK-owned microphone capture for speech-to-text.
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
AudioPlaybackManager
SDK-owned audio playback for synthesized speech.
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
CloudBackend
Generic cloud speech-to-text backend. Fronts one or more HTTP STT providers (Sarvam first); the provider is data carried in each registered model entry.
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
ConsoleLogDestination
Default console sink. Mirrors Swift Logging.printToConsole(_:) — it is held by SDKLoggerConfig (not registered in the destinations list) and invoked only when enableLocalLogging is on.
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
EventBus
Central event bus for generated SDKEvent proto distribution.
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
HybridBatteryFilter
BATTERY hard filter. See HybridFilter.battery.
HybridCapability
HybridCascade
A mid-request fallback trigger. At most one cascade per policy. Evaluated inside commons on the primary candidate's confidence signal (and on a primary error, treated as "no confidence").
HybridConfidenceCascade
Confidence cascade. See HybridCascade.confidence.
HybridCustomFilter
CUSTOM hard filter. See HybridFilter.custom.
HybridDeviceState
Installs / clears the device-state vtable in commons.
HybridDeviceStateProvider
Host-supplied source of the device state the hybrid router needs.
HybridFilter
A hard eligibility predicate. Every filter in a policy must pass for a candidate to survive the filter phase (filters AND-compose). Concrete semantics are evaluated inside commons (NETWORK / Battery against the device-state vtable snapshot; Custom against the registered named predicate).
HybridModel
Identifies one of the two models a hybrid router dispatches between.
HybridModelDescriptor
HybridModelType
HybridNetworkFilter
NETWORK hard filter. See HybridFilter.network.
HybridQualityFilter
QUALITY hard filter. See HybridFilter.quality.
HybridRank
HybridRoutedMetadata
HybridRoutingContext
HybridRoutingPolicy
The full routing policy attached to a model pair: filters (AND-composed), an optional cascade, and a rank. Defaults to HybridRankOrder.preferLocalFirst with no filters or cascade — i.e. "use the local candidate, fall back to online on hard failure".
HybridSttRouter
A hybrid STT router pairing one offline + one online speech service.
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.
LogDestination
A pluggable log sink. Implement this to route SDK logs to your own telemetry/file/network destination. Mirrors Swift's LogDestination protocol. This is a host-side interface (carries no wire payload) and so stays hand-written rather than moving to the proto contract.
LogEntry
LoggingConfiguration
LoggingConfigurations
Per-environment LoggingConfiguration presets. The generated proto message cannot be const-constructed, so the development/staging/production presets live here as factory helpers (mirrors Swift's RALoggingConfiguration extension in SDKLogger.swift).
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
ModelLifecycleChange
One model load/unload transition, decoded from the raw event bus. Mirrors Swift RAModelLifecycleChange (EventBus+ModelLifecycle.swift).
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
RAGModule
RAG module for Retrieval-Augmented Generation.
RAGQueryOptions
RAGQueryRequest
RAGResult
RAGSearchResult
RAGServiceState
RAGStatistics
RAGStreamEvent
RAGStreamEventKind
RegisterModelFromUrlRequest
RegisterMultiFileModelRequest
RoutingPolicy
RunAnywhere
RunAnywhere SDK entry point.
RunAnywhereAudioConvert
Public PCM conversion helpers. One-to-one parity with Swift's extension RunAnywhere in RAAudioConvert.swift.
RunAnywhereDiffusion
Diffusion (image generation) capability surface. Access via RunAnywhere.diffusion.
RunAnywhereDownloads
Downloads / storage-management capability surface.
RunAnywhereEmbeddings
Embeddings capability surface.
RunAnywhereHybrid
Hybrid router capability surface (per-request offline ↔ cloud dispatch).
RunAnywhereLLM
LLM (text generation) capability surface.
RunAnywhereLogging
Static helpers for configuring SDK logging.
RunAnywhereLoRACapability
LoRA (Low-Rank Adaptation) capability surface.
RunAnywhereModelLifecycle
Canonical generated-proto model/component lifecycle surface.
RunAnywhereModels
Model registry capability surface.
RunAnywherePluginLoaderCapability
Plugin Loader capability surface (canonical §12 namespace).
RunAnywhereRAG
RAG (Retrieval-Augmented Generation) capability surface.
RunAnywhereSolutions
Solutions capability surface — RunAnywhere.solutions.
RunAnywhereStorage
Static helpers for storage + low-level download + model registration.
RunAnywhereStructuredOutput
RunAnywhereSTT
STT (speech-to-text) capability surface.
RunAnywhereTools
Tools (function calling) capability surface.
RunAnywhereTTS
TTS (text-to-speech) capability surface.
RunAnywhereVAD
Voice Activity Detection (VAD) capability surface.
RunAnywhereVLM
VLM (vision-language model) capability surface.
RunAnywhereVoice
Voice Agent capability surface.
SDKComponent
SDKConstants
SDK constants
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
SDKInitParams
SdkInitPhase
SdkInitPhase1Request
SdkInitPhase2Request
SdkInitResult
SDKLogger
Centralized logging utility Aligned with iOS: Sources/RunAnywhere/Infrastructure/Logging/SDKLogger.swift
SDKLoggerConfig
Central logging service holding the currently-configured logging configuration + registered destinations. Mirrors Swift's Logging.shared: every SDKLogger record routes through log, which applies the min-level gate, suppresses debug records in production, and fans out to the console
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
SupabaseConfig
SystemTTS
Built-in System TTS module identifiers.
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
VoiceAgentStreamAdapter
Streams VoiceEvents from a C++ voice agent handle.
VoiceAgentSynthesizeSpeechProtoRequest
VoiceAgentTranscribeProtoRequest
Helper-level proto requests for voice-agent sub-components.
VoiceAgentTurnRequest
VoiceEvent
VoiceEventKind
VoiceLifecycleEvent
VoicePipelineComponent
VoiceSessionConfig
VoiceSessionError
WakeWordDetectedEvent
WordTimestamp

Enums

ChatAttachment_Source
ComponentLifecycleEvent_Payload
DownloadEvent_Payload
HybridBackend
Backend identity for a hybrid candidate. Wire values match HybridBackendKind in hybrid_router.proto / rac_hybrid_backend_kind_t. Carries the engine name rac_plugin_find_for_engine pins on for service creation.
HybridCascade_Kind
HybridFilter_Kind
HybridModelKind
Whether a candidate runs on-device or in the cloud. Convenience mirror of ROUTER.OFFLINE / ROUTER.ONLINE in the Kotlin SDK; wire values match HybridModelType in hybrid_router.proto.
HybridRankOrder
Comparator that orders eligible candidates. Exactly one rank per policy. Wire values match HybridRank in hybrid_router.proto.
ModelInfo_Artifact
ModelLifecycleChangeKind
Whether the model finished loading or was unloaded.
ModelRegistryEvent_Result
SDKEvent_Event
SolutionConfig_Config
StorageLifecycleEvent_Result
STTAudioSource_Source
ToolCallingSessionEvent_Kind
ToolValue_Kind
VADAudioSource_Source
VLMImage_Source
VoiceEvent_Payload

Extensions

ErrorCodeClassification on ErrorCode
Mirrors Swift RAErrorCode.isExpected. Used by the logging pipeline to suppress noisy entries for routine cancellation paths.
GeneratedMessageGenericExtensions on T
Extensions on GeneratedMessages.
ModelCategoryDefaults on ModelCategory
SDKEnvironmentExtension on SDKEnvironment
STTConfigurationHelpers on STTConfiguration
Helpers on the proto STTConfiguration message.
TranscriptionMetadataHelpers on TranscriptionMetadata
Helpers on the proto TranscriptionMetadata message — convert the Int64-millisecond fields into idiomatic seconds doubles.
WordTimestampHelpers on WordTimestamp
Helpers on the proto WordTimestamp message — convert the Int64-millisecond fields into idiomatic Durations.

Constants

kHybridDefaultCloudProvider → const String
Default cloud STT provider when a caller omits one. Carried into the descriptor's provider field + the create config so the cloud engine selects the right HTTP backend.
kHybridSttConfidenceThreshold → const double
Suggested default confidence threshold for an STT confidence cascade. Mirrors RAC_HYBRID_STT_CONFIDENCE_THRESHOLD in rac_hybrid_types.h — the router uses the threshold carried in the installed policy; this is only the recommended value to build it with.

Functions

cloudSttConfigJson(CloudSttBackendConfig config) → String
Serialize a generated CloudSttBackendConfig into the config_json string the routed "cloud" plugin's create expects. Carries provider so the engine selects the right HTTP backend. Commons injects a default provider too, but we pass it explicitly so the routed engine never has to guess (mirrors Kotlin/Swift).
formatFramework(InferenceFramework? framework) → String
Return the canonical human-readable display name for an InferenceFramework.
modelLifecycleChange(SDKEvent event) → ModelLifecycleChange?
Decode a raw SDK event into a lifecycle change, or null when the event is not a load/unload transition. Mirrors Swift EventBus.modelLifecycleChange(from:).
wordTimestamp({required String word, required int startMs, required int endMs, double? confidence}) → WordTimestamp
Convenience constructor wrappers — Int64 ergonomics.

Typedefs

ToolExecutor = Future<Map<String, dynamic>> Function(Map<String, dynamic> args)
Executor signature for a tool call.

Exceptions / Errors

AudioPlaybackException
Thrown when audio playback fails. Mirrors Swift AudioPlaybackError.
HybridTranscribeException
Thrown by HybridSttRouter.transcribe when the chosen backend reports a non-zero native rc. Carries the rc + the human-readable error message from the HybridSttTranscribeResponse.
SDKException
Throwable wrapper around the canonical pb.SDKError proto.