@omote/core 0.10.5 → 0.10.6

package/dist/index.d.ts

@@ -3139,6 +3139,83 @@ declare function preloadModels(urls: string[], onProgress?: (current: number, to
  */
 declare function formatBytes(bytes: number): string;
 
+/**
+ * Console Exporter
+ *
+ * Exports telemetry data to the browser console for development/debugging.
+ *
+ * @category Telemetry
+ */
+
+/**
+ * Span data structure for export
+ */
+interface SpanData {
+    name: string;
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    startTime: number;
+    endTime: number;
+    durationMs: number;
+    /** Epoch timestamp in ms for OTLP export (start) */
+    epochMs: number;
+    /** Epoch timestamp in ms for OTLP export (end) */
+    endEpochMs: number;
+    status: 'ok' | 'error';
+    attributes: SpanAttributes;
+    error?: Error;
+}
+/**
+ * Metric data structure for export
+ */
+interface MetricData {
+    name: string;
+    type: 'counter' | 'histogram';
+    value: number;
+    attributes: Record<string, string | number | boolean>;
+    timestamp: number;
+    /** Histogram bucket data for OTLP export */
+    histogramData?: {
+        count: number;
+        sum: number;
+        min: number;
+        max: number;
+        bucketBoundaries: number[];
+        bucketCounts: number[];
+    };
+}
+/**
+ * Exporter interface that all exporters must implement
+ */
+interface TelemetryExporterInterface {
+    /** Export a completed span */
+    exportSpan(span: SpanData): void;
+    /** Export a metric */
+    exportMetric(metric: MetricData): void;
+    /** Flush any buffered data */
+    flush(): Promise<void>;
+    /** Shutdown the exporter */
+    shutdown(): Promise<void>;
+}
+/**
+ * Console exporter for development/debugging
+ *
+ * Outputs spans and metrics to the browser console with formatting.
+ */
+declare class ConsoleExporter implements TelemetryExporterInterface {
+    private enabled;
+    private prefix;
+    constructor(options?: {
+        enabled?: boolean;
+        prefix?: string;
+    });
+    exportSpan(span: SpanData): void;
+    exportMetric(metric: MetricData): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+
 /**
  * Telemetry Types
  *
@@ -3190,6 +3267,8 @@ interface TelemetryConfig {
     metricsEnabled?: boolean;
     /** Metrics export interval in ms. Default: 60000 */
     metricsIntervalMs?: number;
+    /** Custom exporter instance (overrides `exporter` when provided) */
+    customExporter?: TelemetryExporterInterface;
 }
 /**
  * Span attributes for model operations
@@ -3290,20 +3369,9 @@ declare const MetricNames: {
     readonly COMPOSITOR_COMPOSE_LATENCY: "omote.compositor.compose.latency_us";
     /** Counter: Frames exceeding budget threshold */
     readonly AVATAR_FRAME_DROPS: "omote.avatar.frame.drops";
+    /** Counter: Audio scheduling gaps (playback fell behind) */
+    readonly AUDIO_SCHEDULE_GAP: "omote.audio.schedule_gap";
 };
-/**
- * Centralized error type taxonomy for structured error reporting.
- */
-declare const ErrorTypes: {
-    readonly INFERENCE: "inference_error";
-    readonly NETWORK: "network_error";
-    readonly TIMEOUT: "timeout";
-    readonly USER: "user_error";
-    readonly RUNTIME: "runtime_error";
-    readonly MEDIA: "media_error";
-    readonly MODEL: "model_error";
-};
-type ErrorType = typeof ErrorTypes[keyof typeof ErrorTypes];
 /**
  * Histogram buckets for inference latency (ms)
  */
@@ -3379,6 +3447,7 @@ declare function getTelemetry(): OmoteTelemetry | null;
 declare class OmoteTelemetry {
     private config;
     private exporter;
+    private exporterReady;
     private activeTraceId;
     private metricsIntervalId;
     private spanStack;
@@ -3454,7 +3523,7 @@ declare class OmoteTelemetry {
      * });
      * ```
      */
-    recordHistogram(name: string, value: number, attributes?: Record<string, string | number | boolean>): void;
+    recordHistogram(name: string, value: number, attributes?: Record<string, string | number | boolean>, bucketBoundaries?: number[]): void;
     /**
      * Generate unique key for metric with attributes
      */
@@ -3489,70 +3558,6 @@ declare class OmoteTelemetry {
     } | null;
 }
 
-/**
- * Console Exporter
- *
- * Exports telemetry data to the browser console for development/debugging.
- *
- * @category Telemetry
- */
-
-/**
- * Span data structure for export
- */
-interface SpanData {
-    name: string;
-    traceId: string;
-    spanId: string;
-    parentSpanId?: string;
-    startTime: number;
-    endTime: number;
-    durationMs: number;
-    status: 'ok' | 'error';
-    attributes: SpanAttributes;
-    error?: Error;
-}
-/**
- * Metric data structure for export
- */
-interface MetricData {
-    name: string;
-    type: 'counter' | 'histogram';
-    value: number;
-    attributes: Record<string, string | number | boolean>;
-    timestamp: number;
-}
-/**
- * Exporter interface that all exporters must implement
- */
-interface TelemetryExporterInterface {
-    /** Export a completed span */
-    exportSpan(span: SpanData): void;
-    /** Export a metric */
-    exportMetric(metric: MetricData): void;
-    /** Flush any buffered data */
-    flush(): Promise<void>;
-    /** Shutdown the exporter */
-    shutdown(): Promise<void>;
-}
-/**
- * Console exporter for development/debugging
- *
- * Outputs spans and metrics to the browser console with formatting.
- */
-declare class ConsoleExporter implements TelemetryExporterInterface {
-    private enabled;
-    private prefix;
-    constructor(options?: {
-        enabled?: boolean;
-        prefix?: string;
-    });
-    exportSpan(span: SpanData): void;
-    exportMetric(metric: MetricData): void;
-    flush(): Promise<void>;
-    shutdown(): Promise<void>;
-}
-
 /**
  * OTLP Exporter
  *
@@ -4831,4 +4836,4 @@ declare class VoiceOrchestrator extends EventEmitter<VoiceOrchestratorEvents> {
     private setState;
 }
 
-export { type A2EBackend, type A2EModelInfo, A2EProcessor, type A2EProcessorConfig, type A2EResult, A2EUnifiedAdapter, ALL_AUS, ARKIT_BLENDSHAPES, type AUActivation, AU_TO_ARKIT, type ActiveSpan, type AnimationClip, type AnimationController, AnimationGraph, type AnimationGraphConfig, type AnimationGraphEvents, type AnimationLayer, type AnimationOutput, type AnimationSource, type AnimationSourceOptions, type AnimationState, type AnimationStateName, type AnimationTrigger, AudioChunkCoalescer, type AudioChunkCoalescerOptions, AudioEnergyAnalyzer, AudioScheduler, type AudioSchedulerOptions, BLENDSHAPE_TO_GROUP, type BackendPreference, type BlendWeight, type BlendshapeGroup, BlendshapeSmoother, type BlendshapeSmootherConfig, type BoneFilterConfig, type CacheConfig, type CacheSpanAttributes, CharacterController, type CharacterControllerConfig, type CharacterProfile, type CharacterUpdateInput, type CharacterUpdateOutput, ConsoleExporter, type ConversationalState, type CreateA2EConfig, type CreateKokoroTTSConfig, type CreateSenseVoiceConfig, type CreateTTSPlayerConfig, DEFAULT_ANIMATION_CONFIG, DEFAULT_BONE_FILTER, DEFAULT_MODEL_URLS, EMOTION_NAMES, EMOTION_TO_AU, EMOTION_VECTOR_SIZE, EXPLICIT_EMOTION_COUNT, type ElevenLabsConfig, ElevenLabsTTSBackend, type EmotionAnimationMap, EmotionController, type EmotionLabel, type EmotionName, type EmotionPresetName, EmotionPresets, EmotionResolver, type EmotionWeights, EmphasisDetector, type ErrorType, ErrorTypes, EventEmitter, type ExpressionProfile, FaceCompositor, type FaceCompositorConfig, type FaceCompositorInput, type FaceCompositorOutput, type FetchWithCacheOptions, type FrameSource, type FullFaceFrame, HF_CDN_URLS, INFERENCE_LATENCY_BUCKETS, type InferenceFactoryConfig, type InferenceSpanAttributes, type InterruptionConfig, type InterruptionEvents, InterruptionHandler, KOKORO_VOICES, type KokoroStreamChunk, type KokoroTTSConfig, type KokoroTTSModelInfo, type KokoroTTSResult, KokoroTTSUnifiedAdapter, type KokoroVoiceName, LAM_BLENDSHAPES, type LifeLayerConfig, type LifeLayerInput, type LifeLayerOutput, type LoadingProgress, MIXAMO_PREFIX, MODEL_LOAD_TIME_BUCKETS, type MetricData, MetricNames, MicLipSync, type MicLipSyncConfig, type MicLipSyncEvents, type MicLipSyncFrame, type MicLipSyncState, MicrophoneCapture, type MicrophoneCaptureConfig, ModelCache, type ModelSpanAttributes, type ModelUrlKey, OTLPExporter, type OTLPExporterConfig, OmoteEvents, OmoteTelemetry, PRESERVE_POSITION_BONES, PlaybackPipeline, type PlaybackPipelineConfig, type PlaybackPipelineEvents, type PlaybackState, ProceduralLifeLayer, type Quat, type QuotaInfo, type ResolvedEmotion, type ResponseHandler, RingBuffer, type RuntimeBackend, type SafariSpeechConfig, SafariSpeechRecognition, type SamplingConfig, type SenseVoiceBackend, type SenseVoiceConfig, type SenseVoiceLanguage, type SenseVoiceModelInfo, type SenseVoiceResult, SenseVoiceUnifiedAdapter, type SenseVoiceWorkerConfig, type SileroVADBackend, type SileroVADConfig, type SileroVADFactoryConfig, SileroVADUnifiedAdapter, type SpanAttributes, type SpanData, type SpeechErrorCallback, SpeechListener, type SpeechListenerConfig, type SpeechListenerEvents, type SpeechListenerState, type SpeechRecognitionResult, type SpeechResultCallback, type SpeechSegment, type SynthesizeOptions, type TTSBackend, type TTSChunk, TTSPlayback, type TTSPlaybackConfig, type TTSPlaybackEvents, TTSPlayer, TTSSpeaker, type TTSSpeakerConfig, type TTSStreamOptions, type TelemetryConfig, type TelemetryExporter, type TelemetryExporterInterface, type TrackDescriptor, type TranscriptResult, type Transition, UnifiedInferenceWorker, type VADBackend, type VADModelInfo, type VADResult, type VADWorkerConfig, type VADWorkerModelInfo, type ValidationResult, type Vec3, VoiceOrchestrator, type VoiceOrchestratorCloudConfig, type VoiceOrchestratorConfig, type VoiceOrchestratorEvents, type VoiceOrchestratorLocalConfig, type VoicePipelineState, type WorkerHealthState, analyzeTextEmotion, applyProfile, blendEmotions, calculatePeak, calculateRMS, configureCacheLimit, configureModelUrls, configureTelemetry, createA2E, createEmotionVector, createKokoroTTS, createSenseVoice, createSileroVAD, createTTSPlayer, fetchWithCache, float32ToPcm16, formatBytes, getCacheConfig, getCacheKey, getEmotionPreset, getModelCache, getOptimalWasmThreads, getRecommendedBackend, getTelemetry, hasWebGPUApi, int16ToFloat32, isAndroid, isIOS, isIOSSafari, isMobile, isSafari, isSpeechRecognitionAvailable, isWebGPUAvailable, lerpBlendshapes, lerpEmotion, listVoices as listKokoroVoices, parseEmotionTags, pcm16ToFloat32, preloadModels, resampleLinear, resetModelUrls, resolveBackend, resolveEmotion, shouldEnableWasmProxy, shouldKeepTrack, shouldUseNativeASR, shouldUseServerA2E, stripMixamoPrefix, ttsToPlaybackFormat, validateTTSInput };
+export { type A2EBackend, type A2EModelInfo, A2EProcessor, type A2EProcessorConfig, type A2EResult, A2EUnifiedAdapter, ALL_AUS, ARKIT_BLENDSHAPES, type AUActivation, AU_TO_ARKIT, type ActiveSpan, type AnimationClip, type AnimationController, AnimationGraph, type AnimationGraphConfig, type AnimationGraphEvents, type AnimationLayer, type AnimationOutput, type AnimationSource, type AnimationSourceOptions, type AnimationState, type AnimationStateName, type AnimationTrigger, AudioChunkCoalescer, type AudioChunkCoalescerOptions, AudioEnergyAnalyzer, AudioScheduler, type AudioSchedulerOptions, BLENDSHAPE_TO_GROUP, type BackendPreference, type BlendWeight, type BlendshapeGroup, BlendshapeSmoother, type BlendshapeSmootherConfig, type BoneFilterConfig, type CacheConfig, type CacheSpanAttributes, CharacterController, type CharacterControllerConfig, type CharacterProfile, type CharacterUpdateInput, type CharacterUpdateOutput, ConsoleExporter, type ConversationalState, type CreateA2EConfig, type CreateKokoroTTSConfig, type CreateSenseVoiceConfig, type CreateTTSPlayerConfig, DEFAULT_ANIMATION_CONFIG, DEFAULT_BONE_FILTER, DEFAULT_MODEL_URLS, EMOTION_NAMES, EMOTION_TO_AU, EMOTION_VECTOR_SIZE, EXPLICIT_EMOTION_COUNT, type ElevenLabsConfig, ElevenLabsTTSBackend, type EmotionAnimationMap, EmotionController, type EmotionLabel, type EmotionName, type EmotionPresetName, EmotionPresets, EmotionResolver, type EmotionWeights, EmphasisDetector, EventEmitter, type ExpressionProfile, FaceCompositor, type FaceCompositorConfig, type FaceCompositorInput, type FaceCompositorOutput, type FetchWithCacheOptions, type FrameSource, type FullFaceFrame, HF_CDN_URLS, INFERENCE_LATENCY_BUCKETS, type InferenceFactoryConfig, type InferenceSpanAttributes, type InterruptionConfig, type InterruptionEvents, InterruptionHandler, KOKORO_VOICES, type KokoroStreamChunk, type KokoroTTSConfig, type KokoroTTSModelInfo, type KokoroTTSResult, KokoroTTSUnifiedAdapter, type KokoroVoiceName, LAM_BLENDSHAPES, type LifeLayerConfig, type LifeLayerInput, type LifeLayerOutput, type LoadingProgress, MIXAMO_PREFIX, MODEL_LOAD_TIME_BUCKETS, type MetricData, MetricNames, MicLipSync, type MicLipSyncConfig, type MicLipSyncEvents, type MicLipSyncFrame, type MicLipSyncState, MicrophoneCapture, type MicrophoneCaptureConfig, ModelCache, type ModelSpanAttributes, type ModelUrlKey, OTLPExporter, type OTLPExporterConfig, OmoteEvents, OmoteTelemetry, PRESERVE_POSITION_BONES, PlaybackPipeline, type PlaybackPipelineConfig, type PlaybackPipelineEvents, type PlaybackState, ProceduralLifeLayer, type Quat, type QuotaInfo, type ResolvedEmotion, type ResponseHandler, RingBuffer, type RuntimeBackend, type SafariSpeechConfig, SafariSpeechRecognition, type SamplingConfig, type SenseVoiceBackend, type SenseVoiceConfig, type SenseVoiceLanguage, type SenseVoiceModelInfo, type SenseVoiceResult, SenseVoiceUnifiedAdapter, type SenseVoiceWorkerConfig, type SileroVADBackend, type SileroVADConfig, type SileroVADFactoryConfig, SileroVADUnifiedAdapter, type SpanAttributes, type SpanData, type SpeechErrorCallback, SpeechListener, type SpeechListenerConfig, type SpeechListenerEvents, type SpeechListenerState, type SpeechRecognitionResult, type SpeechResultCallback, type SpeechSegment, type SynthesizeOptions, type TTSBackend, type TTSChunk, TTSPlayback, type TTSPlaybackConfig, type TTSPlaybackEvents, TTSPlayer, TTSSpeaker, type TTSSpeakerConfig, type TTSStreamOptions, type TelemetryConfig, type TelemetryExporter, type TelemetryExporterInterface, type TrackDescriptor, type TranscriptResult, type Transition, UnifiedInferenceWorker, type VADBackend, type VADModelInfo, type VADResult, type VADWorkerConfig, type VADWorkerModelInfo, type ValidationResult, type Vec3, VoiceOrchestrator, type VoiceOrchestratorCloudConfig, type VoiceOrchestratorConfig, type VoiceOrchestratorEvents, type VoiceOrchestratorLocalConfig, type VoicePipelineState, type WorkerHealthState, analyzeTextEmotion, applyProfile, blendEmotions, calculatePeak, calculateRMS, configureCacheLimit, configureModelUrls, configureTelemetry, createA2E, createEmotionVector, createKokoroTTS, createSenseVoice, createSileroVAD, createTTSPlayer, fetchWithCache, float32ToPcm16, formatBytes, getCacheConfig, getCacheKey, getEmotionPreset, getModelCache, getOptimalWasmThreads, getRecommendedBackend, getTelemetry, hasWebGPUApi, int16ToFloat32, isAndroid, isIOS, isIOSSafari, isMobile, isSafari, isSpeechRecognitionAvailable, isWebGPUAvailable, lerpBlendshapes, lerpEmotion, listVoices as listKokoroVoices, parseEmotionTags, pcm16ToFloat32, preloadModels, resampleLinear, resetModelUrls, resolveBackend, resolveEmotion, shouldEnableWasmProxy, shouldKeepTrack, shouldUseNativeASR, shouldUseServerA2E, stripMixamoPrefix, ttsToPlaybackFormat, validateTTSInput };