@omote/core 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -1,236 +1,7 @@
+import { EventEmitter, OmoteEvents, AnimationEvent } from './events/index.js';
+export { BackendEvent, EmotionEvent, GazeEvent, STTFinalEvent, STTPartialEvent, SessionStateEvent, TTSEndEvent, TTSMarkEvent, TTSStartEvent, VisemeEvent } from './events/index.js';
 import { InferenceSession, Tensor, Env } from 'onnxruntime-common';
-
-/**
- * Type-safe event emitter for Omote core events
- *
- * @category Events
- */
-type EventCallback<T = unknown> = (data: T) => void;
-declare class EventEmitter<TEvents extends {
-    [key: string]: unknown;
-}> {
-    private listeners;
-    on<K extends keyof TEvents>(event: K, callback: EventCallback<TEvents[K]>): () => void;
-    off<K extends keyof TEvents>(event: K, callback: EventCallback<TEvents[K]>): void;
-    emit<K extends keyof TEvents>(event: K, data: TEvents[K]): void;
-    once<K extends keyof TEvents>(event: K, callback: EventCallback<TEvents[K]>): () => void;
-    removeAllListeners(event?: keyof TEvents): void;
-}
-
-/**
- * Core Omote event types - the contract between core and renderers
- *
- * Renderers subscribe to these events and apply them to their specific
- * rendering system (R3F, Three.js, Babylon, Unity, etc.)
- */
-/** Animation frame with blendshape weights */
-interface AnimationEvent {
-    /** 52 ARKit blendshape weights (0-1 range) */
-    blendshapes: Float32Array;
-    /** Named blendshape access */
-    get(name: string): number;
-    /** Raw model output weights (for debugging) */
-    rawWeights?: Float32Array;
-    /** Timestamp in ms */
-    timestamp: number;
-    /** Inference latency in ms */
-    inferenceMs: number;
-    /** Frame index within the current batch (for LAM multi-frame output) */
-    frameIndex?: number;
-    /** Total frames in the current batch (for LAM multi-frame output) */
-    totalFrames?: number;
-}
-/** Viseme for lip sync */
-interface VisemeEvent {
-    /** Viseme ID or phoneme */
-    viseme: string;
-    /** Weight 0-1 */
-    weight: number;
-    /** Duration in ms */
-    duration: number;
-}
-/** Emotion state change */
-interface EmotionEvent {
-    /** Emotion weights by name */
-    values: Record<string, number>;
-    /** Transition duration in ms */
-    transitionMs: number;
-}
-/** Gaze target change */
-interface GazeEvent {
-    /** Target type */
-    target: 'camera' | 'wander' | 'position';
-    /** Position if target is 'position' */
-    position?: {
-        x: number;
-        y: number;
-        z: number;
-    };
-}
-/** Audio playback events */
-interface TTSStartEvent {
-    /** Audio duration in ms */
-    durationMs: number;
-    /** Text being spoken */
-    text: string;
-}
-interface TTSMarkEvent {
-    /** Mark name/type */
-    name: string;
-    /** Time offset in ms */
-    timeMs: number;
-}
-interface TTSEndEvent {
-    /** Whether playback completed normally */
-    completed: boolean;
-}
-/** STT transcription events */
-interface STTPartialEvent {
-    /** Partial transcription */
-    text: string;
-    /** Confidence 0-1 */
-    confidence: number;
-}
-interface STTFinalEvent {
-    /** Final transcription */
-    text: string;
-    /** Confidence 0-1 */
-    confidence: number;
-}
-/** Session state events */
-interface SessionStateEvent {
-    state: 'connecting' | 'connected' | 'ready' | 'streaming' | 'error' | 'disconnected';
-    error?: Error;
-}
-/** Backend info */
-interface BackendEvent {
-    type: 'webgpu' | 'wasm' | 'remote';
-    modelLoaded: boolean;
-    loadTimeMs?: number;
-}
-/** AI adapter state */
-type AISessionState$1 = 'idle' | 'listening' | 'thinking' | 'speaking' | 'interrupted' | 'error' | 'disconnected';
-/** AI state change event */
-interface AIStateChangeEvent {
-    state: AISessionState$1;
-    previousState: AISessionState$1;
-}
-/** User speech events */
-interface UserSpeechStartEvent {
-    timestamp: number;
-}
-interface UserSpeechEndEvent {
-    timestamp: number;
-    durationMs: number;
-}
-interface UserTranscriptEvent {
-    text: string;
-    confidence: number;
-}
-/** AI response events */
-interface AIThinkingStartEvent {
-    timestamp: number;
-}
-interface AIResponseStartEvent {
-    text?: string;
-    emotion?: string;
-}
-interface AIResponseChunkEvent {
-    text: string;
-    isLast: boolean;
-}
-interface AIResponseEndEvent {
-    fullText: string;
-    durationMs: number;
-}
-/** Audio output events (for lip sync processing) */
-interface AudioOutputChunkEvent {
-    audio: ArrayBuffer;
-    sampleRate: number;
-    timestamp: number;
-}
-interface AudioOutputEndEvent {
-    durationMs: number;
-}
-/** Adapter events */
-interface AdapterSwitchEvent {
-    from: string;
-    to: string;
-    reason: string;
-}
-interface AdapterFallbackEvent {
-    adapter: string;
-    reason: string;
-}
-interface InterruptionEvent {
-    timestamp: number;
-    action?: 'stop' | 'continue';
-}
-/**
- * Complete event map for OmoteCore
- */
-type OmoteEvents = {
-    'animation': AnimationEvent;
-    'animation.ready': {
-        backend: 'webgpu' | 'wasm';
-    };
-    'viseme': VisemeEvent;
-    'emotion': EmotionEvent;
-    'gaze': GazeEvent;
-    'tts.start': TTSStartEvent;
-    'tts.mark': TTSMarkEvent;
-    'tts.end': TTSEndEvent;
-    'stt.partial': STTPartialEvent;
-    'stt.final': STTFinalEvent;
-    'session.state': SessionStateEvent;
-    'backend': BackendEvent;
-    'audio.chunk': {
-        pcm: Int16Array;
-        timestamp: number;
-    };
-    'audio.level': {
-        rms: number;
-        peak: number;
-    };
-    'audio.output.chunk': AudioOutputChunkEvent;
-    'audio.output.end': AudioOutputEndEvent;
-    'ai.state.change': AIStateChangeEvent;
-    'ai.thinking.start': AIThinkingStartEvent;
-    'ai.response.start': AIResponseStartEvent;
-    'ai.response.chunk': AIResponseChunkEvent;
-    'ai.response.end': AIResponseEndEvent;
-    'user.speech.start': UserSpeechStartEvent;
-    'user.speech.end': UserSpeechEndEvent;
-    'user.transcript.partial': UserTranscriptEvent;
-    'user.transcript.final': UserTranscriptEvent;
-    'adapter.switch': AdapterSwitchEvent;
-    'adapter.fallback': AdapterFallbackEvent;
-    'adapter.recovered': {
-        adapter: string;
-    };
-    'interruption.detected': InterruptionEvent;
-    'interruption.handled': InterruptionEvent;
-    'memory.updated': {
-        messageCount: number;
-        tokenCount?: number;
-    };
-    'connection.opened': {
-        sessionId: string;
-        adapter?: string;
-    };
-    'connection.closed': {
-        reason: string;
-    };
-    'connection.error': {
-        error: Error;
-        recoverable: boolean;
-    };
-    'error': {
-        code: string;
-        message: string;
-        details?: unknown;
-    };
-};
+export { D as DEFAULT_LOGGING_CONFIG, I as ILogger, e as LOG_LEVEL_PRIORITY, b as LogEntry, L as LogFormatter, a as LogLevel, c as LogSink, d as LoggingConfig, f as configureLogging, i as createLogger, g as getLoggingConfig, n as noopLogger, r as resetLoggingConfig, s as setLogLevel, h as setLoggingEnabled } from './Logger-I_k4sGhM.js';
 
 /**
  * Microphone capture - renderer-agnostic audio input
@@ -3276,138 +3047,6 @@ declare function scanForInvalidCaches(): Promise<{
  */
 declare function nukeBrowserCaches(preventRecreation?: boolean): Promise<number>;
 
-/**
- * Logging types for Omote SDK
- *
- * 6-level logging system with structured output:
- * - error: Critical failures that prevent operation
- * - warn: Recoverable issues or degraded performance
- * - info: Key lifecycle events (model loaded, inference complete)
- * - debug: Detailed operational info for development
- * - trace: Fine-grained tracing for performance analysis
- * - verbose: Extremely detailed output (tensor shapes, intermediate values)
- */
-type LogLevel = 'error' | 'warn' | 'info' | 'debug' | 'trace' | 'verbose';
-/**
- * Numeric priority for log levels (lower = more severe)
- */
-declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
-/**
- * Structured log entry
- */
-interface LogEntry {
-    /** Unix timestamp in milliseconds */
-    timestamp: number;
-    /** Log level */
-    level: LogLevel;
-    /** Module name (e.g., 'LocalInference', 'ModelCache') */
-    module: string;
-    /** Human-readable message */
-    message: string;
-    /** Optional structured data */
-    data?: Record<string, unknown>;
-    /** Optional error object */
-    error?: Error;
-}
-/**
- * Log output sink interface
- */
-interface LogSink {
-    (entry: LogEntry): void;
-}
-/**
- * Log formatter interface
- */
-interface LogFormatter {
-    (entry: LogEntry): string;
-}
-/**
- * Global logging configuration
- */
-interface LoggingConfig {
-    /** Minimum log level to output (default: 'info') */
-    level: LogLevel;
-    /** Enable/disable logging globally (default: true) */
-    enabled: boolean;
-    /** Output format: 'json' for structured, 'pretty' for human-readable */
-    format: 'json' | 'pretty';
-    /** Custom output sink (default: console) */
-    sink?: LogSink;
-    /** Include timestamps in output (default: true) */
-    timestamps?: boolean;
-    /** Include module name in output (default: true) */
-    includeModule?: boolean;
-}
-/**
- * Logger interface for module-specific logging
- */
-interface ILogger {
-    error(message: string, data?: Record<string, unknown>): void;
-    warn(message: string, data?: Record<string, unknown>): void;
-    info(message: string, data?: Record<string, unknown>): void;
-    debug(message: string, data?: Record<string, unknown>): void;
-    trace(message: string, data?: Record<string, unknown>): void;
-    verbose(message: string, data?: Record<string, unknown>): void;
-    /** Create a child logger with a sub-module name */
-    child(subModule: string): ILogger;
-    /** Get the module name for this logger */
-    readonly module: string;
-}
-/**
- * Default configuration
- */
-declare const DEFAULT_LOGGING_CONFIG: LoggingConfig;
-
-/**
- * Omote SDK Logger
- *
- * Unified logging system with:
- * - 6 log levels (error, warn, info, debug, trace, verbose)
- * - Structured JSON output for machine parsing
- * - Pretty output for human readability
- * - Module-based child loggers
- * - Runtime configuration
- * - Browser and Node.js compatible
- */
-
-/**
- * Configure global logging settings
- */
-declare function configureLogging(config: Partial<LoggingConfig>): void;
-/**
- * Get current logging configuration
- */
-declare function getLoggingConfig(): LoggingConfig;
-/**
- * Reset logging configuration to defaults
- */
-declare function resetLoggingConfig(): void;
-/**
- * Set log level at runtime
- */
-declare function setLogLevel(level: LogLevel): void;
-/**
- * Enable or disable logging
- */
-declare function setLoggingEnabled(enabled: boolean): void;
-/**
- * Create a logger for a specific module
- *
- * @param module - Module name (e.g., 'LocalInference', 'ModelCache')
- * @returns Logger instance
- *
- * @example
- * ```typescript
- * const logger = createLogger('LocalInference');
- * logger.info('Model loaded', { backend: 'webgpu', loadTimeMs: 1234 });
- * ```
- */
-declare function createLogger(module: string): ILogger;
-/**
- * No-op logger for when logging is completely disabled
- */
-declare const noopLogger: ILogger;
-
 /**
  * Telemetry Types
  *
@@ -4170,4 +3809,4 @@ declare class EmphasisDetector {
     reset(): void;
 }
 
-export { type AIAdapter, type AIAdapterEvents, type AISessionState, type ActiveSpan, AgentCoreAdapter, type AgentCoreConfig, type AnimationClip, type AnimationEvent, AnimationGraph, type AnimationGraphConfig, type AnimationGraphEvents, type AnimationLayer, type AnimationOutput, type AnimationState, type AnimationStateName, type AnimationTrigger, AudioChunkCoalescer, type AudioChunkCoalescerOptions, AudioEnergyAnalyzer, AudioScheduler, type AudioSchedulerOptions, type AudioSyncConfig, type AudioSyncEvents, AudioSyncManager, type BackendEvent, type BackendPreference, type BlendWeight, CTC_VOCAB, type CacheConfig, type CacheSpanAttributes, ConsoleExporter, type ConversationMessage, ConversationOrchestrator, type ConversationSession, DEFAULT_ANIMATION_CONFIG, DEFAULT_LOGGING_CONFIG, EMOTION_NAMES, EMOTION_VECTOR_SIZE, type EmotionAnimationMap, EmotionController, type EmotionEvent, type EmotionLabel, type EmotionName, type EmotionPresetName, EmotionPresets, type EmotionWeights, EmphasisDetector, EventEmitter, type FetchWithCacheOptions, type GazeEvent, HF_CDN_TEST_URL, type HuggingFaceUrlInfo, type ILogger, INFERENCE_LATENCY_BUCKETS, type InferenceSpanAttributes, type InterruptionConfig, type InterruptionEvents, InterruptionHandler, type LAMFrame, LAMPipeline, type LAMPipelineOptions, LAM_BLENDSHAPES, LOG_LEVEL_PRIORITY, type LogEntry, type LogFormatter, type LogLevel, type LogSink, type LoggingConfig, MODEL_LOAD_TIME_BUCKETS, type MessageRole, type MetricData, MetricNames, MicrophoneCapture, type MicrophoneCaptureConfig, ModelCache, type ModelSpanAttributes, OTLPExporter, type OTLPExporterConfig, type OmoteEvents, OmoteTelemetry, type OrchestratorConfig, type OrchestratorEvents, type QuotaInfo, RingBuffer, type RuntimeBackend, type STTFinalEvent, type STTPartialEvent, type SafariSpeechConfig, SafariSpeechRecognition, type SamplingConfig, type SessionConfig, type SessionOptions, type SessionSnapshot, type SessionStateEvent, type SileroVADBackend, type SileroVADConfig, type SileroVADFactoryConfig, SileroVADInference, SileroVADWorker, type SpanAttributes, type SpanData, type SpeechErrorCallback, type SpeechRecognitionResult, type SpeechResultCallback, type SpeechSegment, SyncedAudioPipeline, type SyncedAudioPipelineEvents, type SyncedAudioPipelineOptions, type TTSEndEvent, type TTSMarkEvent, type TTSStartEvent, type TelemetryConfig, type TelemetryExporter, type TelemetryExporterInterface, type TenantConfig, TenantManager, type TenantQuota, type TenantUsage, type TokenRefreshCallback, type TranscriptionResult, type Transition, type VADBackend, type VADModelInfo, type VADResult$1 as VADResult, type VADWorkerConfig, type VADWorkerModelInfo, type ValidationResult, type VisemeEvent, type VoiceConfig, Wav2Vec2Inference, type Wav2Vec2InferenceConfig, type Wav2Vec2Result, type WhisperConfig, WhisperInference, type WhisperModel, blendEmotions, calculatePeak, calculateRMS, clearSpecificCache, clearTransformersCache, configureCacheLimit, configureLogging, configureTelemetry, createEmotionVector, createLogger, createSessionWithFallback, createSileroVAD, fetchWithCache, formatBytes, getCacheConfig, getCacheKey, getEmotionPreset, getLoadedBackend, getLoggingConfig, getModelCache, getOnnxRuntime, getOnnxRuntimeForPreference, getOptimalWasmThreads, getRecommendedBackend, getSessionOptions, getTelemetry, hasWebGPUApi, isAndroid, isHuggingFaceCDNReachable, isIOS, isIOSSafari, isMobile, isOnnxRuntimeLoaded, isSpeechRecognitionAvailable, isWebGPUAvailable, lerpEmotion, listCaches, noopLogger, nukeBrowserCaches, parseHuggingFaceUrl, preloadModels, resetLoggingConfig, resolveBackend, scanForInvalidCaches, setLogLevel, setLoggingEnabled, shouldEnableWasmProxy, shouldUseNativeASR, shouldUseServerLipSync, supportsVADWorker, validateCachedResponse };
+export { type AIAdapter, type AIAdapterEvents, type AISessionState, type ActiveSpan, AgentCoreAdapter, type AgentCoreConfig, type AnimationClip, AnimationEvent, AnimationGraph, type AnimationGraphConfig, type AnimationGraphEvents, type AnimationLayer, type AnimationOutput, type AnimationState, type AnimationStateName, type AnimationTrigger, AudioChunkCoalescer, type AudioChunkCoalescerOptions, AudioEnergyAnalyzer, AudioScheduler, type AudioSchedulerOptions, type AudioSyncConfig, type AudioSyncEvents, AudioSyncManager, type BackendPreference, type BlendWeight, CTC_VOCAB, type CacheConfig, type CacheSpanAttributes, ConsoleExporter, type ConversationMessage, ConversationOrchestrator, type ConversationSession, DEFAULT_ANIMATION_CONFIG, EMOTION_NAMES, EMOTION_VECTOR_SIZE, type EmotionAnimationMap, EmotionController, type EmotionLabel, type EmotionName, type EmotionPresetName, EmotionPresets, type EmotionWeights, EmphasisDetector, EventEmitter, type FetchWithCacheOptions, HF_CDN_TEST_URL, type HuggingFaceUrlInfo, INFERENCE_LATENCY_BUCKETS, type InferenceSpanAttributes, type InterruptionConfig, type InterruptionEvents, InterruptionHandler, type LAMFrame, LAMPipeline, type LAMPipelineOptions, LAM_BLENDSHAPES, MODEL_LOAD_TIME_BUCKETS, type MessageRole, type MetricData, MetricNames, MicrophoneCapture, type MicrophoneCaptureConfig, ModelCache, type ModelSpanAttributes, OTLPExporter, type OTLPExporterConfig, OmoteEvents, OmoteTelemetry, type OrchestratorConfig, type OrchestratorEvents, type QuotaInfo, RingBuffer, type RuntimeBackend, type SafariSpeechConfig, SafariSpeechRecognition, type SamplingConfig, type SessionConfig, type SessionOptions, type SessionSnapshot, type SileroVADBackend, type SileroVADConfig, type SileroVADFactoryConfig, SileroVADInference, SileroVADWorker, type SpanAttributes, type SpanData, type SpeechErrorCallback, type SpeechRecognitionResult, type SpeechResultCallback, type SpeechSegment, SyncedAudioPipeline, type SyncedAudioPipelineEvents, type SyncedAudioPipelineOptions, type TelemetryConfig, type TelemetryExporter, type TelemetryExporterInterface, type TenantConfig, TenantManager, type TenantQuota, type TenantUsage, type TokenRefreshCallback, type TranscriptionResult, type Transition, type VADBackend, type VADModelInfo, type VADResult$1 as VADResult, type VADWorkerConfig, type VADWorkerModelInfo, type ValidationResult, type VoiceConfig, Wav2Vec2Inference, type Wav2Vec2InferenceConfig, type Wav2Vec2Result, type WhisperConfig, WhisperInference, type WhisperModel, blendEmotions, calculatePeak, calculateRMS, clearSpecificCache, clearTransformersCache, configureCacheLimit, configureTelemetry, createEmotionVector, createSessionWithFallback, createSileroVAD, fetchWithCache, formatBytes, getCacheConfig, getCacheKey, getEmotionPreset, getLoadedBackend, getModelCache, getOnnxRuntime, getOnnxRuntimeForPreference, getOptimalWasmThreads, getRecommendedBackend, getSessionOptions, getTelemetry, hasWebGPUApi, isAndroid, isHuggingFaceCDNReachable, isIOS, isIOSSafari, isMobile, isOnnxRuntimeLoaded, isSpeechRecognitionAvailable, isWebGPUAvailable, lerpEmotion, listCaches, nukeBrowserCaches, parseHuggingFaceUrl, preloadModels, resolveBackend, scanForInvalidCaches, shouldEnableWasmProxy, shouldUseNativeASR, shouldUseServerLipSync, supportsVADWorker, validateCachedResponse };