@charivo/core 0.31.0 → 0.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -381,6 +381,17 @@ interface TTSManager {
381
381
  /** Final resource release; call stop() first - dispose() does not stop playback. */
382
382
  dispose?(): Promise<void>;
383
383
  }
384
+ /**
385
+ * `TTSManager` with the members the built-in manager always provides required
386
+ * instead of optional. A third-party `TTSManager` may omit audio preparation,
387
+ * event wiring, or disposal; the manager returned by `createTTSManager` never
388
+ * does, so callers of the factory should not have to narrow them.
389
+ */
390
+ interface BuiltInTTSManager extends TTSManager {
391
+ prepareAudio(): Promise<void>;
392
+ setEventEmitter(eventEmitter: CharivoEventEmitter): void;
393
+ dispose(): Promise<void>;
394
+ }
384
395
  interface STTOptions {
385
396
  language?: string;
386
397
  }
@@ -400,6 +411,13 @@ interface STTManager {
400
411
  isRecording(): boolean;
401
412
  setEventEmitter?(eventEmitter: CharivoEventEmitter): void;
402
413
  }
414
+ /**
415
+ * `STTManager` with event wiring required instead of optional — the manager
416
+ * returned by `createSTTManager` always provides it.
417
+ */
418
+ interface BuiltInSTTManager extends STTManager {
419
+ setEventEmitter(eventEmitter: CharivoEventEmitter): void;
420
+ }
403
421
  interface RealtimeManager {
404
422
  setCharacter(character: Character): void;
405
423
  getState(): RealtimeState;
@@ -415,6 +433,14 @@ interface RealtimeManager {
415
433
  getRegisteredTools(): ToolDefinition[];
416
434
  setEventEmitter?(eventEmitter: CharivoEventEmitter): void;
417
435
  }
436
+ /**
437
+ * `RealtimeManager` with the members the built-in manager always provides
438
+ * required instead of optional — `createRealtimeManager` implements both.
439
+ */
440
+ interface BuiltInRealtimeManager extends RealtimeManager {
441
+ prepareAudio(config?: RealtimeSessionConfig): Promise<void>;
442
+ setEventEmitter(eventEmitter: CharivoEventEmitter): void;
443
+ }
418
444
  /**
419
445
  * An interface (not a type alias) so third-party packages can extend it via
420
446
  * declaration merging — a custom renderer or manager declares its own events
@@ -974,4 +1000,4 @@ interface CharivoOptions {
974
1000
  */
975
1001
  declare function createCharivo(options?: CharivoOptions): Charivo;
976
1002
 
977
- export { type AvatarControlCatalog, type BrowserLifecycleCallbacks, type Character, Charivo, CharivoDisposeError, CharivoError, type CharivoErrorCode, type CharivoErrorKind, type CharivoErrorOptions, type CharivoEventBus, type CharivoEventEmitter, type CharivoOptions, CharivoProviderError, CharivoStateError, CharivoTimeoutError, CharivoTransportError, DEFAULT_FETCH_TIMEOUT_MS, type EventMap, type FetchWithTimeoutOptions, type GazeCoordinates, type GenerateResponseOptions, type HistoryRollback, type LLMAdapter, type LLMCallOptions, type LLMClient, type LLMManager, type LLMManagerWithTools, type LLMMessage, type LLMProvider, type LLMToolCall, type LLMToolResponse, type LipSyncAnalyzer, type LipSyncAnalyzerOptions, type Message, type MotionSelection, OPENAI_REALTIME_ADAPTER, OPENAI_REALTIME_AGENTS_ADAPTER, type RealtimeConnectionState, type RealtimeManager, type RealtimeProvider, type RealtimeReconnectCause, type RealtimeResponseStatus, type RealtimeSessionBootstrap, type RealtimeSessionConfig, type RealtimeSessionRequest, type RealtimeSessionStatus, type RealtimeSessionTransitionReason, type RealtimeState, type RealtimeToolChoice, type RealtimeTransportKind, type RealtimeUsageEvent, type RenderManager, type Renderer, type STTManager, type STTOptions, type STTProvider, type STTTranscriber, type TTSManager, type TTSOptions, type TTSPlaybackMode, type TTSPlayer, type TTSProvider, type ToolContext, type ToolDefinition, type ToolHandler, type ToolRegistration, type ToolRegistry, type ToolResultProjector, type ToolResultProjectorContext, type ToolResultSnapshot, assertToolResultObject, createCharivo, createLipSyncAnalyzer, createToolFailureOutput, createToolRegistry, fetchWithTimeout, getErrorMessage, isCharivoError, snapshotToolResult, subscribeBrowserLifecycle, toCharivoError, validateToolArguments, withToolTimeout };
1003
+ export { type AvatarControlCatalog, type BrowserLifecycleCallbacks, type BuiltInRealtimeManager, type BuiltInSTTManager, type BuiltInTTSManager, type Character, Charivo, CharivoDisposeError, CharivoError, type CharivoErrorCode, type CharivoErrorKind, type CharivoErrorOptions, type CharivoEventBus, type CharivoEventEmitter, type CharivoOptions, CharivoProviderError, CharivoStateError, CharivoTimeoutError, CharivoTransportError, DEFAULT_FETCH_TIMEOUT_MS, type EventMap, type FetchWithTimeoutOptions, type GazeCoordinates, type GenerateResponseOptions, type HistoryRollback, type LLMAdapter, type LLMCallOptions, type LLMClient, type LLMManager, type LLMManagerWithTools, type LLMMessage, type LLMProvider, type LLMToolCall, type LLMToolResponse, type LipSyncAnalyzer, type LipSyncAnalyzerOptions, type Message, type MotionSelection, OPENAI_REALTIME_ADAPTER, OPENAI_REALTIME_AGENTS_ADAPTER, type RealtimeConnectionState, type RealtimeManager, type RealtimeProvider, type RealtimeReconnectCause, type RealtimeResponseStatus, type RealtimeSessionBootstrap, type RealtimeSessionConfig, type RealtimeSessionRequest, type RealtimeSessionStatus, type RealtimeSessionTransitionReason, type RealtimeState, type RealtimeToolChoice, type RealtimeTransportKind, type RealtimeUsageEvent, type RenderManager, type Renderer, type STTManager, type STTOptions, type STTProvider, type STTTranscriber, type TTSManager, type TTSOptions, type TTSPlaybackMode, type TTSPlayer, type TTSProvider, type ToolContext, type ToolDefinition, type ToolHandler, type ToolRegistration, type ToolRegistry, type ToolResultProjector, type ToolResultProjectorContext, type ToolResultSnapshot, assertToolResultObject, createCharivo, createLipSyncAnalyzer, createToolFailureOutput, createToolRegistry, fetchWithTimeout, getErrorMessage, isCharivoError, snapshotToolResult, subscribeBrowserLifecycle, toCharivoError, validateToolArguments, withToolTimeout };
package/dist/index.d.ts CHANGED
@@ -381,6 +381,17 @@ interface TTSManager {
381
381
  /** Final resource release; call stop() first - dispose() does not stop playback. */
382
382
  dispose?(): Promise<void>;
383
383
  }
384
+ /**
385
+ * `TTSManager` with the members the built-in manager always provides required
386
+ * instead of optional. A third-party `TTSManager` may omit audio preparation,
387
+ * event wiring, or disposal; the manager returned by `createTTSManager` never
388
+ * does, so callers of the factory should not have to narrow them.
389
+ */
390
+ interface BuiltInTTSManager extends TTSManager {
391
+ prepareAudio(): Promise<void>;
392
+ setEventEmitter(eventEmitter: CharivoEventEmitter): void;
393
+ dispose(): Promise<void>;
394
+ }
384
395
  interface STTOptions {
385
396
  language?: string;
386
397
  }
@@ -400,6 +411,13 @@ interface STTManager {
400
411
  isRecording(): boolean;
401
412
  setEventEmitter?(eventEmitter: CharivoEventEmitter): void;
402
413
  }
414
+ /**
415
+ * `STTManager` with event wiring required instead of optional — the manager
416
+ * returned by `createSTTManager` always provides it.
417
+ */
418
+ interface BuiltInSTTManager extends STTManager {
419
+ setEventEmitter(eventEmitter: CharivoEventEmitter): void;
420
+ }
403
421
  interface RealtimeManager {
404
422
  setCharacter(character: Character): void;
405
423
  getState(): RealtimeState;
@@ -415,6 +433,14 @@ interface RealtimeManager {
415
433
  getRegisteredTools(): ToolDefinition[];
416
434
  setEventEmitter?(eventEmitter: CharivoEventEmitter): void;
417
435
  }
436
+ /**
437
+ * `RealtimeManager` with the members the built-in manager always provides
438
+ * required instead of optional — `createRealtimeManager` implements both.
439
+ */
440
+ interface BuiltInRealtimeManager extends RealtimeManager {
441
+ prepareAudio(config?: RealtimeSessionConfig): Promise<void>;
442
+ setEventEmitter(eventEmitter: CharivoEventEmitter): void;
443
+ }
418
444
  /**
419
445
  * An interface (not a type alias) so third-party packages can extend it via
420
446
  * declaration merging — a custom renderer or manager declares its own events
@@ -974,4 +1000,4 @@ interface CharivoOptions {
974
1000
  */
975
1001
  declare function createCharivo(options?: CharivoOptions): Charivo;
976
1002
 
977
- export { type AvatarControlCatalog, type BrowserLifecycleCallbacks, type Character, Charivo, CharivoDisposeError, CharivoError, type CharivoErrorCode, type CharivoErrorKind, type CharivoErrorOptions, type CharivoEventBus, type CharivoEventEmitter, type CharivoOptions, CharivoProviderError, CharivoStateError, CharivoTimeoutError, CharivoTransportError, DEFAULT_FETCH_TIMEOUT_MS, type EventMap, type FetchWithTimeoutOptions, type GazeCoordinates, type GenerateResponseOptions, type HistoryRollback, type LLMAdapter, type LLMCallOptions, type LLMClient, type LLMManager, type LLMManagerWithTools, type LLMMessage, type LLMProvider, type LLMToolCall, type LLMToolResponse, type LipSyncAnalyzer, type LipSyncAnalyzerOptions, type Message, type MotionSelection, OPENAI_REALTIME_ADAPTER, OPENAI_REALTIME_AGENTS_ADAPTER, type RealtimeConnectionState, type RealtimeManager, type RealtimeProvider, type RealtimeReconnectCause, type RealtimeResponseStatus, type RealtimeSessionBootstrap, type RealtimeSessionConfig, type RealtimeSessionRequest, type RealtimeSessionStatus, type RealtimeSessionTransitionReason, type RealtimeState, type RealtimeToolChoice, type RealtimeTransportKind, type RealtimeUsageEvent, type RenderManager, type Renderer, type STTManager, type STTOptions, type STTProvider, type STTTranscriber, type TTSManager, type TTSOptions, type TTSPlaybackMode, type TTSPlayer, type TTSProvider, type ToolContext, type ToolDefinition, type ToolHandler, type ToolRegistration, type ToolRegistry, type ToolResultProjector, type ToolResultProjectorContext, type ToolResultSnapshot, assertToolResultObject, createCharivo, createLipSyncAnalyzer, createToolFailureOutput, createToolRegistry, fetchWithTimeout, getErrorMessage, isCharivoError, snapshotToolResult, subscribeBrowserLifecycle, toCharivoError, validateToolArguments, withToolTimeout };
1003
+ export { type AvatarControlCatalog, type BrowserLifecycleCallbacks, type BuiltInRealtimeManager, type BuiltInSTTManager, type BuiltInTTSManager, type Character, Charivo, CharivoDisposeError, CharivoError, type CharivoErrorCode, type CharivoErrorKind, type CharivoErrorOptions, type CharivoEventBus, type CharivoEventEmitter, type CharivoOptions, CharivoProviderError, CharivoStateError, CharivoTimeoutError, CharivoTransportError, DEFAULT_FETCH_TIMEOUT_MS, type EventMap, type FetchWithTimeoutOptions, type GazeCoordinates, type GenerateResponseOptions, type HistoryRollback, type LLMAdapter, type LLMCallOptions, type LLMClient, type LLMManager, type LLMManagerWithTools, type LLMMessage, type LLMProvider, type LLMToolCall, type LLMToolResponse, type LipSyncAnalyzer, type LipSyncAnalyzerOptions, type Message, type MotionSelection, OPENAI_REALTIME_ADAPTER, OPENAI_REALTIME_AGENTS_ADAPTER, type RealtimeConnectionState, type RealtimeManager, type RealtimeProvider, type RealtimeReconnectCause, type RealtimeResponseStatus, type RealtimeSessionBootstrap, type RealtimeSessionConfig, type RealtimeSessionRequest, type RealtimeSessionStatus, type RealtimeSessionTransitionReason, type RealtimeState, type RealtimeToolChoice, type RealtimeTransportKind, type RealtimeUsageEvent, type RenderManager, type Renderer, type STTManager, type STTOptions, type STTProvider, type STTTranscriber, type TTSManager, type TTSOptions, type TTSPlaybackMode, type TTSPlayer, type TTSProvider, type ToolContext, type ToolDefinition, type ToolHandler, type ToolRegistration, type ToolRegistry, type ToolResultProjector, type ToolResultProjectorContext, type ToolResultSnapshot, assertToolResultObject, createCharivo, createLipSyncAnalyzer, createToolFailureOutput, createToolRegistry, fetchWithTimeout, getErrorMessage, isCharivoError, snapshotToolResult, subscribeBrowserLifecycle, toCharivoError, validateToolArguments, withToolTimeout };