@charivo/core 0.18.0 → 0.20.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/README.md CHANGED
@@ -12,8 +12,10 @@ It exports:
12
12
  and realtime clients use to compute mouth-open RMS and emit
13
13
  `tts:lipsync:update`
14
14
  - modality-neutral tool contracts (`ToolDefinition`, `ToolRegistration`, ...)
15
- and validation helpers (`validateToolArguments`, `assertToolResultObject`)
16
- shared by `@charivo/llm` and `@charivo/realtime`
15
+ plus the validation and execution helpers (`validateToolArguments`,
16
+ `assertToolResultObject`, `createToolRegistry`, `withToolTimeout`,
17
+ `snapshotToolResult`, `createToolFailureOutput`) shared by `@charivo/llm`
18
+ and `@charivo/realtime`
17
19
 
18
20
  ## Install
19
21
 
@@ -115,6 +117,28 @@ Validation helpers, used by both managers before/after a handler runs:
115
117
  - `assertToolResultObject(result, toolName, toolLabel?)`: throws a plain
116
118
  `Error` unless `result` is a plain object.
117
119
 
120
+ Execution helpers, shared so both managers run tools with the same guarantees:
121
+
122
+ - `createToolRegistry(): ToolRegistry`: name-keyed registry
123
+ (`register` / `unregister` / `get` / `size` / `getDefinitions`).
124
+ `getDefinitions()` deep-copies, so a provider cannot mutate a registered
125
+ schema.
126
+ - `withToolTimeout(promise, timeoutMs, toolName, toolLabel?)`: rejects with
127
+ `${toolLabel} "${toolName}" timed out after ${timeoutMs}ms` and always clears
128
+ its timer.
129
+ - `snapshotToolResult(result, toolName, toolLabel?): ToolResultSnapshot`:
130
+ serializes once and returns `{ serialized, snapshot }` — the string for the
131
+ model's tool turn or the transport, and its parsed form for the `tool:result`
132
+ event and the result projectors. Call it inside a runner's failure boundary
133
+ so an unrepresentable result degrades to a failure output: `JSON.stringify`
134
+ returns the value `undefined` (without throwing) for a result whose
135
+ `toJSON()` yields `undefined`, and a `toJSON()` can also yield null, an
136
+ array, or a primitive, so the parsed value is re-checked against the
137
+ tool-result contract. Both tool runners use this, which is what makes a tool
138
+ result mean the same thing across modalities.
139
+ - `createToolFailureOutput(error)`: the always-serializable
140
+ `{ success: false, error }` output handed back to the model when a call fails.
141
+
118
142
  ### LLM Tool-Calling Contracts
119
143
 
120
144
  - `LLMMessage`: role-discriminated union (`system`/`user`, `assistant` with
@@ -147,6 +171,10 @@ Important event names include:
147
171
  - `stt:partial`
148
172
  - `stt:stop`
149
173
  - `stt:error`
174
+ - `llm:error`
175
+ - `tool:call`
176
+ - `tool:result`
177
+ - `tool:error`
150
178
  - `realtime:session:start`
151
179
  - `realtime:session:end`
152
180
  - `realtime:state`
@@ -154,12 +182,12 @@ Important event names include:
154
182
  - `realtime:assistant:start`
155
183
  - `realtime:assistant:delta`
156
184
  - `realtime:assistant:done`
157
- - `realtime:tool:call`
158
- - `realtime:tool:result`
159
- - `realtime:tool:error`
160
185
  - `realtime:usage`
161
186
  - `avatar:expression`
162
187
  - `avatar:motion`
163
188
  - `avatar:gaze`
164
- - `realtime:text:delta`
165
189
  - `realtime:error`
190
+
191
+ `EventBus.emit(...)` isolates each listener: one that throws is reported via
192
+ `console.error` and does not stop the listeners queued behind it, so `emit`
193
+ never throws into its caller.
package/dist/index.cjs CHANGED
@@ -8,7 +8,13 @@ var EventBus = class {
8
8
  this.listeners[event].push(listener);
9
9
  }
10
10
  emit(event, data) {
11
- this.listeners[event]?.forEach((listener) => listener(data));
11
+ this.listeners[event]?.forEach((listener) => {
12
+ try {
13
+ listener(data);
14
+ } catch (error) {
15
+ console.error(`Event listener for "${String(event)}" threw:`, error);
16
+ }
17
+ });
12
18
  }
13
19
  off(event, listener) {
14
20
  const eventListeners = this.listeners[event];
@@ -431,6 +437,73 @@ function isRecord(value) {
431
437
  return typeof value === "object" && value !== null;
432
438
  }
433
439
 
440
+ // src/tool-execution.ts
441
+ function createToolRegistry() {
442
+ const tools = /* @__PURE__ */ new Map();
443
+ return {
444
+ register(tool) {
445
+ tools.set(tool.definition.name, tool);
446
+ },
447
+ unregister(name) {
448
+ tools.delete(name);
449
+ },
450
+ get(name) {
451
+ return tools.get(name);
452
+ },
453
+ size() {
454
+ return tools.size;
455
+ },
456
+ getDefinitions() {
457
+ return Array.from(
458
+ tools.values(),
459
+ (tool) => JSON.parse(JSON.stringify(tool.definition))
460
+ );
461
+ }
462
+ };
463
+ }
464
+ function createToolFailureOutput(error) {
465
+ return {
466
+ success: false,
467
+ error: error.message
468
+ };
469
+ }
470
+ async function withToolTimeout(promise, timeoutMs, toolName, toolLabel = "Tool") {
471
+ let timeoutId;
472
+ try {
473
+ return await Promise.race([
474
+ promise,
475
+ new Promise((_, reject) => {
476
+ timeoutId = setTimeout(() => {
477
+ reject(
478
+ new Error(
479
+ `${toolLabel} "${toolName}" timed out after ${timeoutMs}ms`
480
+ )
481
+ );
482
+ }, timeoutMs);
483
+ })
484
+ ]);
485
+ } finally {
486
+ if (timeoutId !== void 0) {
487
+ clearTimeout(timeoutId);
488
+ }
489
+ }
490
+ }
491
+ function serializeToolResult(result, toolName, toolLabel = "Tool") {
492
+ const serialized = JSON.stringify(result);
493
+ if (typeof serialized !== "string") {
494
+ throw new Error(
495
+ `${toolLabel} "${toolName}" result could not be serialized to JSON`
496
+ );
497
+ }
498
+ return serialized;
499
+ }
500
+ function snapshotToolResult(result, toolName, toolLabel = "Tool") {
501
+ const serialized = serializeToolResult(result, toolName, toolLabel);
502
+ const parsed = JSON.parse(serialized);
503
+ assertToolResultObject(parsed, toolName, toolLabel);
504
+ return { serialized, snapshot: parsed };
505
+ }
506
+
434
507
  // src/index.ts
435
508
  var Charivo = class {
436
509
  eventBus;
@@ -797,10 +870,14 @@ exports.OPENAI_REALTIME_ADAPTER = OPENAI_REALTIME_ADAPTER;
797
870
  exports.OPENAI_REALTIME_AGENTS_ADAPTER = OPENAI_REALTIME_AGENTS_ADAPTER;
798
871
  exports.assertToolResultObject = assertToolResultObject;
799
872
  exports.createLipSyncAnalyzer = createLipSyncAnalyzer;
873
+ exports.createToolFailureOutput = createToolFailureOutput;
874
+ exports.createToolRegistry = createToolRegistry;
800
875
  exports.getErrorMessage = getErrorMessage;
801
876
  exports.isCharivoError = isCharivoError;
877
+ exports.snapshotToolResult = snapshotToolResult;
802
878
  exports.subscribeBrowserLifecycle = subscribeBrowserLifecycle;
803
879
  exports.toCharivoError = toCharivoError;
804
880
  exports.validateToolArguments = validateToolArguments;
881
+ exports.withToolTimeout = withToolTimeout;
805
882
  //# sourceMappingURL=index.cjs.map
806
883
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/bus.ts","../src/errors.ts","../src/types.ts","../src/browser-lifecycle.ts","../src/lipsync-analyzer.ts","../src/tool-validation.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import { CharivoEventBus, EventMap } from \"./types\";\n\ntype ListenerStore = {\n [K in keyof EventMap]?: Array<(data: EventMap[K]) => void>;\n};\n\nexport class EventBus implements CharivoEventBus {\n private listeners: ListenerStore = {};\n\n on<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void {\n this.listeners[event] ??= [];\n this.listeners[event]!.push(listener);\n }\n\n emit<K extends keyof EventMap>(event: K, data: EventMap[K]): void {\n this.listeners[event]?.forEach((listener) => listener(data));\n }\n\n off<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void {\n const eventListeners = this.listeners[event];\n if (!eventListeners) {\n return;\n }\n\n const index = eventListeners.indexOf(listener);\n if (index > -1) {\n eventListeners.splice(index, 1);\n }\n\n if (eventListeners.length === 0) {\n delete this.listeners[event];\n }\n }\n\n clear(): void {\n this.listeners = {};\n }\n}\n","export type CharivoErrorCode =\n | \"CHARIVO_ERROR\"\n | \"CHARIVO_STATE_ERROR\"\n | \"CHARIVO_TIMEOUT_ERROR\"\n | \"CHARIVO_TRANSPORT_ERROR\"\n | \"CHARIVO_PROVIDER_ERROR\"\n | \"CHARIVO_DISPOSE_ERROR\";\n\nexport interface CharivoErrorOptions extends ErrorOptions {\n code?: CharivoErrorCode;\n}\n\nexport class CharivoError extends Error {\n readonly code: CharivoErrorCode;\n\n constructor(message: string, options: CharivoErrorOptions = {}) {\n super(message, options);\n this.name = \"CharivoError\";\n this.code = options.code ?? \"CHARIVO_ERROR\";\n }\n}\n\nexport class CharivoStateError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_STATE_ERROR\",\n });\n this.name = \"CharivoStateError\";\n }\n}\n\nexport class CharivoTimeoutError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_TIMEOUT_ERROR\",\n });\n this.name = \"CharivoTimeoutError\";\n }\n}\n\nexport class CharivoTransportError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_TRANSPORT_ERROR\",\n });\n this.name = \"CharivoTransportError\";\n }\n}\n\nexport class CharivoProviderError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_PROVIDER_ERROR\",\n });\n this.name = \"CharivoProviderError\";\n }\n}\n\nexport class CharivoDisposeError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_DISPOSE_ERROR\",\n });\n this.name = \"CharivoDisposeError\";\n }\n}\n\nexport type CharivoErrorKind =\n | \"state\"\n | \"timeout\"\n | \"transport\"\n | \"provider\"\n | \"dispose\";\n\nexport function isCharivoError(error: unknown): error is CharivoError {\n return error instanceof CharivoError;\n}\n\nexport function getErrorMessage(\n error: unknown,\n fallback = \"Unknown error\",\n): string {\n if (typeof error === \"string\" && error.trim().length > 0) {\n return error;\n }\n\n if (error instanceof Error && error.message.trim().length > 0) {\n return error.message;\n }\n\n return fallback;\n}\n\nexport function toCharivoError(\n kind: CharivoErrorKind,\n error: unknown,\n fallbackMessage?: string,\n): CharivoError {\n if (isCharivoError(error)) {\n return error;\n }\n\n const message = getErrorMessage(error, fallbackMessage);\n const options =\n error instanceof Error\n ? {\n cause: error,\n }\n : undefined;\n\n switch (kind) {\n case \"state\":\n return new CharivoStateError(message, options);\n case \"timeout\":\n return new CharivoTimeoutError(message, options);\n case \"transport\":\n return new CharivoTransportError(message, options);\n case \"provider\":\n return new CharivoProviderError(message, options);\n case \"dispose\":\n return new CharivoDisposeError(message, options);\n }\n}\n","export interface MotionSelection {\n group: string;\n index?: number;\n}\n\nexport interface GazeCoordinates {\n x: number;\n y: number;\n}\n\nexport interface AvatarControlCatalog {\n expressions: string[];\n motions: Record<string, number>;\n}\n\nexport interface Character {\n id: string;\n name: string;\n description?: string;\n personality?: string;\n avatar?: string;\n voice?: {\n voiceId?: string;\n rate?: number;\n pitch?: number;\n volume?: number;\n };\n}\n\nexport interface Message {\n id: string;\n content: string;\n timestamp: Date;\n characterId?: string;\n type: \"user\" | \"character\" | \"system\";\n}\n\nexport interface Conversation {\n id: string;\n messages: Message[];\n characterId?: string;\n createdAt: Date;\n updatedAt: Date;\n}\n\nexport interface Plugin {\n id: string;\n name: string;\n version: string;\n enabled: boolean;\n}\n\nexport interface CharivoConfig {\n characters: Character[];\n plugins: Plugin[];\n llmProvider?: string;\n renderProvider?: string;\n}\n\nexport type RealtimeTransportKind = \"webrtc\" | \"websocket\";\n\nexport type RealtimeToolChoice = \"auto\" | \"none\" | \"required\";\nexport const OPENAI_REALTIME_ADAPTER = \"openai-webrtc\";\nexport const OPENAI_REALTIME_AGENTS_ADAPTER = \"openai-agents-webrtc\";\n\n// Modality-neutral tool contracts (used by realtime and LLM sessions)\nexport interface ToolDefinition {\n type: \"function\";\n name: string;\n description: string;\n /**\n * JSON Schema-shaped. `validateToolArguments` only enforces required-key\n * presence, enum membership, and each property's top-level `type`; nested\n * schemas, `additionalProperties`, and numeric-length constraints are not\n * validated.\n */\n parameters: {\n type: \"object\";\n properties: Record<string, unknown>;\n required?: string[];\n };\n}\n\nexport interface ToolContext {\n character?: Character | null;\n callId?: string;\n /** Present only for realtime sessions. */\n state?: RealtimeState;\n}\n\n/** Must resolve to a plain object; arrays and primitives are rejected by the runners. */\nexport type ToolHandler = (\n args: Record<string, unknown>,\n context: ToolContext,\n) => Promise<Record<string, unknown>>;\n\nexport interface ToolRegistration {\n definition: ToolDefinition;\n handler: ToolHandler;\n /** Timeout in ms; falls back to the manager default when omitted. */\n timeoutMs?: number;\n}\n\nexport interface ToolResultProjectorContext {\n name: string;\n output: Record<string, unknown>;\n callId?: string;\n emit<K extends keyof EventMap>(event: K, payload: EventMap[K]): void;\n}\n\nexport type ToolResultProjector = (context: ToolResultProjectorContext) => void;\n\nexport interface RealtimeSessionConfig {\n provider?: string;\n transport?: RealtimeTransportKind;\n voice?: string;\n model?: string;\n instructions?: string;\n temperature?: number;\n maxTokens?: number;\n tools?: ToolDefinition[];\n toolChoice?: RealtimeToolChoice;\n inputAudioTranscription?: {\n model?: string;\n enabled?: boolean;\n };\n}\n\nexport interface RealtimeSessionRequest {\n adapter?: string;\n transport: RealtimeTransportKind;\n session: RealtimeSessionConfig;\n sdpOffer?: string;\n}\n\nexport type RealtimeSessionBootstrap =\n | {\n adapter: string;\n transport: \"webrtc\";\n answerSdp: string;\n }\n | {\n adapter: string;\n transport: \"webrtc\";\n clientSecret: string;\n }\n | {\n adapter: string;\n transport: \"websocket\";\n url: string;\n token: string;\n };\n\nexport interface RealtimeProvider {\n createSession(\n request: RealtimeSessionRequest,\n ): Promise<RealtimeSessionBootstrap>;\n}\n\nexport type RealtimeConnectionState =\n | \"idle\"\n | \"connecting\"\n | \"connected\"\n | \"disconnecting\"\n | \"error\";\n\nexport type RealtimeReconnectCause =\n | \"ice-disconnected\"\n | \"ice-failed\"\n | \"connection-failed\"\n | \"offline\"\n | \"online\"\n | \"visibility\"\n | \"pagehide\"\n | \"pageshow\";\n\nexport type RealtimeSessionStatus = \"idle\" | \"starting\" | \"active\" | \"stopped\";\nexport type RealtimeSessionTransitionReason = \"user\" | \"refresh\";\n\nexport type RealtimeResponseStatus =\n | \"idle\"\n | \"responding\"\n | \"interrupted\"\n | \"completed\";\n\nexport interface RealtimeState {\n connection: RealtimeConnectionState;\n session: {\n status: RealtimeSessionStatus;\n config: RealtimeSessionConfig | null;\n characterId?: string;\n };\n response: {\n status: RealtimeResponseStatus;\n text: string;\n };\n lastError: Error | null;\n}\n\nexport interface RealtimeUsageEvent {\n usage: Record<string, unknown>;\n model?: string;\n responseId?: string;\n sessionId?: string;\n}\n\nexport interface LLMAdapter {\n generateResponse(message: Message): Promise<string>;\n setCharacter(character: Character): void;\n clearHistory(): void;\n}\n\nexport interface LLMToolCall {\n id: string;\n name: string;\n /** JSON-decoded; the provider/client adapter parses the raw tool-call arguments before this contract is used. */\n arguments: Record<string, unknown>;\n}\n\n/**\n * Role-discriminated union so protocol-invalid combinations are unrepresentable\n * for typed direct callers: unknown roles, tool turns without an ID, and tool\n * calls on user turns cannot be expressed.\n */\nexport type LLMMessage =\n | { role: \"system\" | \"user\"; content: string }\n | { role: \"assistant\"; content: string; toolCalls?: LLMToolCall[] }\n | { role: \"tool\"; content: string; toolCallId: string };\n\nexport interface LLMToolResponse {\n content: string;\n toolCalls?: LLMToolCall[];\n}\n\n// LLM provider (generates LLM responses server-side)\nexport interface LLMProvider {\n generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string>;\n /** Tool-calling variant; providers that support function calling implement this alongside generateResponse. */\n generateResponseWithTools?(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse>;\n}\n\n// Simple LLM call client (stateless)\nexport interface LLMClient {\n call(messages: Array<{ role: string; content: string }>): Promise<string>;\n /** Tool-calling variant; clients that support function calling implement this alongside call. */\n callWithTools?(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse>;\n}\n\n// LLM manager (session management, history, character management)\nexport interface LLMManager {\n setCharacter(character: Character): void;\n getCharacter(): Character | null;\n clearHistory(): void;\n getHistory(): Message[];\n generateResponse(message: Message): Promise<string>;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n registerTool?(tool: ToolRegistration): void;\n unregisterTool?(name: string): void;\n getRegisteredTools?(): ToolDefinition[];\n /** System-prompt-level instructions injected only when tools are registered; pass null to clear. */\n setToolInstructions?(instructions: string | null): void;\n}\n\n/**\n * `LLMManager` with the tool-calling members required instead of optional.\n * Third-party `LLMManager` implementations may omit tool support, but the\n * built-in manager returned by `createLLMManager` always provides it.\n */\nexport interface LLMManagerWithTools extends LLMManager {\n setEventEmitter(eventEmitter: CharivoEventEmitter): void;\n registerTool(tool: ToolRegistration): void;\n unregisterTool(name: string): void;\n getRegisteredTools(): ToolDefinition[];\n setToolInstructions(instructions: string | null): void;\n}\n\n// Renderer interface (stateless renderer)\nexport interface Renderer {\n initialize(): Promise<void>;\n destroy(): Promise<void>;\n render(message: Message, character?: Character): Promise<void>;\n loadModel?(modelPath: string): Promise<void>;\n setRealtimeLipSync?(enabled: boolean): void;\n updateRealtimeLipSyncRms?(rms: number): void;\n playExpression?(expressionId: string): void;\n playMotionByGroup?(group: string, index: number): void;\n lookAt?(coords: GazeCoordinates): void;\n getAvailableExpressions?(): string[];\n getAvailableMotionGroups?(): Record<string, number>;\n}\n\n// Render manager (session management, lip-sync, motion control)\nexport interface RenderManager {\n initialize(): Promise<void>;\n destroy(): Promise<void>;\n setCharacter(character: Character): void;\n render(message: Message, character?: Character): Promise<void>;\n /** Local-presence gaze (webcam), peer of mouse-tracking. Returns true when applied. */\n setLocalGaze?(coords: GazeCoordinates): boolean;\n setEventBus(eventBus: CharivoEventBus): void;\n /** Removes all event-bus listeners registered by setEventBus. */\n disconnect(): void;\n loadModel?(modelPath: string): Promise<void>;\n setMessageCallback?(\n callback: (message: Message, character?: Character) => void,\n ): void;\n}\n\nexport interface TTSOptions {\n rate?: number;\n pitch?: number;\n volume?: number;\n voice?: string;\n}\n\nexport type TTSPlaybackMode = \"audio\" | \"web-speech\";\n\n// TTS player (plays audio in the browser)\nexport interface TTSPlayer {\n /**\n * Explicit playback mode for the manager. Prefer setting this on concrete\n * players instead of relying on constructor-name inference.\n */\n readonly playbackMode?: TTSPlaybackMode;\n /**\n * MIME type used when the manager turns generated audio into a Blob.\n */\n readonly audioMimeType?: string;\n speak(text: string, options?: TTSOptions): Promise<void>;\n stop(): Promise<void>;\n setVoice(voice: string): void;\n isSupported(): boolean;\n /**\n * Stateless audio generation. Required for the `\"audio\"` playback mode: the\n * manager creates the audio element itself so it can analyze playback for\n * lip-sync. Players that can only `speak()` must use `\"web-speech\"` mode.\n */\n generateAudio?(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n}\n\n// TTS provider (generates audio data)\nexport interface TTSProvider {\n generateSpeech(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n setVoice(voice: string): void;\n}\n\n// TTS Manager - interface responsible for managing the state of a TTS session\nexport interface TTSManager {\n speak(text: string, options?: TTSOptions): Promise<void>;\n stop(): Promise<void>;\n setVoice(voice: string): void;\n isSupported(): boolean;\n /** Creates the audio analysis context up front; call from a user gesture handler so browsers allow playback later. */\n prepareAudio?(): Promise<void>;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n /** Final resource release; call stop() first - dispose() does not stop playback. */\n dispose?(): Promise<void>;\n}\n\nexport interface STTOptions {\n language?: string;\n}\n\n// STT provider (converts audio data to text)\nexport interface STTProvider {\n transcribe(audio: Blob | ArrayBuffer, options?: STTOptions): Promise<string>;\n}\n\n// STT transcriber (browser-side audio transcription)\n// Each transcriber handles recording internally\nexport interface STTTranscriber {\n startRecording(options?: STTOptions): Promise<void>;\n stopRecording(): Promise<string>;\n isRecording(): boolean;\n /** Optional: subscribe to cumulative interim transcript snapshots (streaming transcribers only). */\n onPartial?(callback: (transcription: string) => void): void;\n}\n\n// STT Manager - Manages STT session state\nexport interface STTManager {\n start(options?: STTOptions): Promise<void>;\n stop(): Promise<string>;\n isRecording(): boolean;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n}\n\n// Realtime Manager - Manages Realtime API session state\nexport interface RealtimeManager {\n setCharacter(character: Character): void;\n getState(): RealtimeState;\n prepareAudio?(config?: RealtimeSessionConfig): Promise<void>;\n startSession(config?: RealtimeSessionConfig): Promise<void>;\n updateSession(config?: RealtimeSessionConfig): Promise<void>;\n stopSession(): Promise<void>;\n sendMessage(text: string): Promise<void>;\n sendAudioChunk(audio: ArrayBuffer): Promise<void>;\n interrupt(): Promise<void>;\n registerTool(tool: ToolRegistration): void;\n unregisterTool(name: string): void;\n getRegisteredTools(): ToolDefinition[];\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n}\n\nexport type EventMap = {\n \"message:sent\": { message: Message };\n \"message:received\": { message: Message };\n \"character:speak\": { character: Character; message: string };\n \"tts:start\": { text: string; characterId?: string };\n \"tts:end\": { characterId?: string };\n \"tts:error\": { error: Error };\n \"tts:audio:start\": { characterId?: string };\n \"tts:audio:end\": { characterId?: string };\n \"tts:lipsync:update\": { rms: number; characterId?: string };\n \"stt:start\": { options?: STTOptions };\n \"stt:partial\": { transcription: string };\n \"stt:stop\": { transcription: string };\n \"stt:error\": { error: Error };\n \"realtime:session:start\": {\n state: RealtimeState;\n reason?: RealtimeSessionTransitionReason;\n };\n \"realtime:session:end\": {\n state: RealtimeState;\n reason?: RealtimeSessionTransitionReason;\n };\n \"realtime:state\": { state: RealtimeState };\n \"realtime:user:transcript\": { text: string };\n \"realtime:assistant:start\": { state: RealtimeState };\n \"realtime:assistant:delta\": { text: string };\n \"realtime:assistant:done\": { text: string };\n \"realtime:tool:call\": {\n name: string;\n args: Record<string, unknown>;\n callId?: string;\n };\n \"realtime:tool:result\": {\n name: string;\n output: Record<string, unknown>;\n callId?: string;\n };\n \"realtime:tool:error\": {\n name: string;\n error: Error;\n callId?: string;\n };\n \"realtime:reconnect:attempt\": {\n attempt: number;\n delayMs: number;\n cause: RealtimeReconnectCause;\n };\n \"realtime:reconnect:success\": {\n attempts: number;\n totalMs: number;\n cause: RealtimeReconnectCause;\n };\n \"realtime:reconnect:exhausted\": {\n attempts: number;\n totalMs: number;\n cause: RealtimeReconnectCause;\n lastError: Error;\n };\n \"realtime:usage\": RealtimeUsageEvent;\n \"avatar:expression\": { expressionId: string };\n \"avatar:motion\": { group: string; index: number };\n \"avatar:gaze\": GazeCoordinates;\n \"realtime:text:delta\": { text: string };\n \"realtime:error\": { error: Error };\n error: { error: Error };\n};\n\nexport interface CharivoEventEmitter {\n emit<K extends keyof EventMap>(event: K, data: EventMap[K]): void;\n}\n\nexport interface CharivoEventBus extends CharivoEventEmitter {\n on<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void;\n off<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void;\n}\n","export interface BrowserLifecycleCallbacks {\n onHidden?(): void;\n onOnline?(): void;\n onPageHide?(event: PageTransitionEvent): void;\n onPageShow?(event: PageTransitionEvent): void;\n onVisible?(): void;\n}\n\nconst subscribers = new Set<BrowserLifecycleCallbacks>();\n\nlet installed = false;\n\nfunction handleVisibilityChange(): void {\n for (const subscriber of subscribers) {\n if (document.visibilityState === \"visible\") {\n subscriber.onVisible?.();\n continue;\n }\n\n subscriber.onHidden?.();\n }\n}\n\nfunction handleOnline(): void {\n for (const subscriber of subscribers) {\n subscriber.onOnline?.();\n }\n}\n\nfunction handlePageHide(event: PageTransitionEvent): void {\n for (const subscriber of subscribers) {\n subscriber.onPageHide?.(event);\n }\n}\n\nfunction handlePageShow(event: PageTransitionEvent): void {\n for (const subscriber of subscribers) {\n subscriber.onPageShow?.(event);\n }\n}\n\nfunction installListeners(): void {\n if (\n installed ||\n typeof window === \"undefined\" ||\n typeof document === \"undefined\"\n ) {\n return;\n }\n\n installed = true;\n document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n window.addEventListener(\"online\", handleOnline);\n window.addEventListener(\"pagehide\", handlePageHide);\n window.addEventListener(\"pageshow\", handlePageShow);\n}\n\nfunction uninstallListeners(): void {\n if (\n !installed ||\n typeof window === \"undefined\" ||\n typeof document === \"undefined\"\n ) {\n return;\n }\n\n installed = false;\n document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n window.removeEventListener(\"online\", handleOnline);\n window.removeEventListener(\"pagehide\", handlePageHide);\n window.removeEventListener(\"pageshow\", handlePageShow);\n}\n\nexport function subscribeBrowserLifecycle(\n callbacks: BrowserLifecycleCallbacks,\n): () => void {\n if (typeof window === \"undefined\" || typeof document === \"undefined\") {\n return () => undefined;\n }\n\n subscribers.add(callbacks);\n installListeners();\n\n return () => {\n subscribers.delete(callbacks);\n if (subscribers.size === 0) {\n uninstallListeners();\n }\n };\n}\n","/**\n * Shared lip sync audio analysis: the single RMS computation used across the repo.\n */\nexport const LIPSYNC_FFT_SIZE = 256;\nexport const LIPSYNC_SMOOTHING_TIME_CONSTANT = 0.8;\n\n/**\n * Compute a mouth-open value from frequency data, focusing on speech frequencies.\n */\nexport function computeLipSyncRms(frequencyData: Uint8Array): number {\n // 10-60% of the spectrum (~2-14kHz at a 48kHz context)\n const speechBandStart = Math.floor(frequencyData.length * 0.1);\n const speechBandEnd = Math.floor(frequencyData.length * 0.6);\n\n let sum = 0;\n for (let index = speechBandStart; index < speechBandEnd; index += 1) {\n const normalized = frequencyData[index] / 255;\n sum += normalized * normalized;\n }\n\n const rms = Math.sqrt(sum / (speechBandEnd - speechBandStart));\n return Math.min(rms * 1.7, 1); // Amplify and clamp\n}\n\nexport interface LipSyncAnalyzerOptions {\n onRms: (rms: number) => void;\n onError?: (error: unknown) => void;\n}\n\nexport interface LipSyncAnalyzer {\n /**\n * Create the AudioContext up front (idempotent).\n */\n prepare(): Promise<void>;\n /**\n * Analyze an audio element while keeping its playback audible.\n */\n attachMediaElement(element: HTMLAudioElement): void;\n /**\n * Analyze a media stream without routing it to the speakers.\n */\n attachMediaStream(stream: MediaStream): void;\n /**\n * Temporarily halt analysis; `resume()` restarts it.\n */\n pause(): void;\n resume(): void;\n /**\n * Halt analysis for the current source. `resume()` no-ops until the next attach.\n */\n stop(): void;\n cleanup(): Promise<void>;\n}\n\nclass LipSyncAnalyzerImpl implements LipSyncAnalyzer {\n private audioContext?: AudioContext;\n private analyser?: AnalyserNode;\n private source?: AudioNode;\n private attachedStream?: MediaStream;\n private dataArray?: Uint8Array<ArrayBuffer>;\n private isActive = false;\n private animationFrameId?: number;\n\n constructor(private options: LipSyncAnalyzerOptions) {}\n\n async prepare(): Promise<void> {\n if (this.audioContext) {\n return;\n }\n\n const audioContextConstructor =\n typeof window === \"undefined\"\n ? undefined\n : window.AudioContext ||\n (window as Window & { webkitAudioContext?: typeof AudioContext })\n .webkitAudioContext;\n if (!audioContextConstructor) {\n throw new Error(\"AudioContext is not supported in this browser\");\n }\n\n this.audioContext = new audioContextConstructor();\n }\n\n attachMediaElement(element: HTMLAudioElement): void {\n this.stop();\n this.resetNodes();\n\n try {\n const audioContext = this.ensureAudioContext();\n if (!audioContext) {\n return;\n }\n\n const analyser = this.createAnalyser(audioContext);\n const source = audioContext.createMediaElementSource(element);\n source.connect(analyser);\n analyser.connect(audioContext.destination); // Keep playback audible\n\n this.startAnalysis(source, analyser);\n\n // Resume audio context if suspended (required on some browsers)\n if (audioContext.state === \"suspended\") {\n element.addEventListener(\n \"play\",\n () => {\n this.audioContext?.resume();\n },\n { once: true },\n );\n }\n } catch (error) {\n this.options.onError?.(error);\n }\n }\n\n attachMediaStream(stream: MediaStream): void {\n if (this.attachedStream === stream) {\n return;\n }\n\n this.stop();\n this.resetNodes();\n\n try {\n const audioContext = this.ensureAudioContext();\n if (!audioContext) {\n return;\n }\n\n const analyser = this.createAnalyser(audioContext);\n const source = audioContext.createMediaStreamSource(stream);\n source.connect(analyser); // Not connected to the destination: the stream is already audible\n\n this.startAnalysis(source, analyser);\n\n // Memoize only after success so a failed attach stays retryable\n this.attachedStream = stream;\n } catch (error) {\n this.options.onError?.(error);\n }\n }\n\n pause(): void {\n this.cancelLoop();\n this.options.onRms(0);\n }\n\n resume(): void {\n if (\n !this.isActive ||\n this.animationFrameId !== undefined ||\n !this.analyser ||\n !this.dataArray\n ) {\n return;\n }\n\n this.analyzeFrame();\n }\n\n stop(): void {\n this.isActive = false;\n this.attachedStream = undefined;\n this.cancelLoop();\n this.options.onRms(0); // Reset mouth to closed position\n }\n\n async cleanup(): Promise<void> {\n // Clear every reference synchronously so a prepare() racing an in-flight\n // close() creates a fresh context instead of reusing the closing one.\n this.stop();\n this.resetNodes();\n this.dataArray = undefined;\n\n const audioContext = this.audioContext;\n this.audioContext = undefined;\n\n await audioContext?.close();\n }\n\n /**\n * Create the context lazily so callers can attach without awaiting prepare().\n *\n * This relies on prepare() staying await-free before it assigns\n * `this.audioContext`: the void call below runs its body synchronously, so\n * the context is already visible when this returns on the same tick.\n */\n private ensureAudioContext(): AudioContext | undefined {\n if (!this.audioContext) {\n void this.prepare().catch((error) => {\n this.options.onError?.(error);\n });\n }\n\n return this.audioContext;\n }\n\n private createAnalyser(audioContext: AudioContext): AnalyserNode {\n const analyser = audioContext.createAnalyser();\n analyser.fftSize = LIPSYNC_FFT_SIZE;\n analyser.smoothingTimeConstant = LIPSYNC_SMOOTHING_TIME_CONSTANT;\n return analyser;\n }\n\n private startAnalysis(source: AudioNode, analyser: AnalyserNode): void {\n this.source = source;\n this.analyser = analyser;\n this.dataArray = new Uint8Array(analyser.frequencyBinCount);\n this.isActive = true;\n this.analyzeFrame();\n }\n\n private analyzeFrame(): void {\n if (!this.isActive || !this.analyser || !this.dataArray) {\n return;\n }\n\n this.analyser.getByteFrequencyData(this.dataArray);\n this.options.onRms(computeLipSyncRms(this.dataArray));\n\n this.animationFrameId = requestAnimationFrame(() => this.analyzeFrame());\n }\n\n private cancelLoop(): void {\n if (this.animationFrameId !== undefined) {\n cancelAnimationFrame(this.animationFrameId);\n this.animationFrameId = undefined;\n }\n }\n\n private resetNodes(): void {\n if (this.source) {\n this.source.disconnect();\n this.source = undefined;\n }\n\n if (this.analyser) {\n this.analyser.disconnect();\n this.analyser = undefined;\n }\n }\n}\n\nexport function createLipSyncAnalyzer(\n options: LipSyncAnalyzerOptions,\n): LipSyncAnalyzer {\n return new LipSyncAnalyzerImpl(options);\n}\n","/**\n * Shared tool validation: the single argument/result contract enforced before\n * and after a tool handler runs, regardless of the modality that calls it.\n *\n * Errors here are plain `Error`, not a `CharivoErrorKind` variant, on purpose:\n * this preserves message-string compatibility with the pre-move realtime\n * validator, and no existing error kind fits schema validation.\n */\nimport type { ToolDefinition } from \"./types\";\n\n/**\n * Validates tool call arguments against a definition's parameter schema.\n *\n * Enforces only: required-key presence, `enum` membership, and each\n * property's top-level `type`. Nested schemas, `additionalProperties`, and\n * numeric-length constraints (`minLength`, `maximum`, etc.) are not\n * validated. Throws a plain `Error` on the first violation found.\n *\n * @param toolLabel - Prefixes thrown messages (e.g. `${toolLabel} \"name\" ...`);\n * callers use this to distinguish realtime tools from other modalities.\n */\nexport function validateToolArguments(\n definition: ToolDefinition,\n args: unknown,\n toolLabel = \"Tool\",\n): void {\n if (!isRecord(args) || Array.isArray(args)) {\n throw new Error(\n `${toolLabel} \"${definition.name}\" arguments failed schema validation: arguments must be an object`,\n );\n }\n\n const { parameters } = definition;\n const required = parameters.required ?? [];\n\n for (const propertyName of required) {\n if (!hasOwnProperty(args, propertyName)) {\n throw new Error(\n `${toolLabel} \"${definition.name}\" arguments failed schema validation: missing required property \"${propertyName}\"`,\n );\n }\n }\n\n for (const [propertyName, schema] of Object.entries(parameters.properties)) {\n if (!hasOwnProperty(args, propertyName) || !isRecord(schema)) {\n continue;\n }\n\n validateToolArgumentValue(\n definition.name,\n propertyName,\n args[propertyName],\n schema,\n toolLabel,\n );\n }\n}\n\n/**\n * Tool handlers must resolve to a plain object; arrays and primitives are not\n * serializable tool outputs. Throws a plain `Error` on violation.\n *\n * @param toolLabel - Prefixes the thrown message (e.g. `${toolLabel} \"name\" ...`);\n * callers use this to distinguish realtime tools from other modalities.\n */\nexport function assertToolResultObject(\n result: unknown,\n toolName: string,\n toolLabel = \"Tool\",\n): asserts result is Record<string, unknown> {\n if (!isRecord(result) || Array.isArray(result)) {\n throw new Error(`${toolLabel} \"${toolName}\" must return an object`);\n }\n}\n\nfunction validateToolArgumentValue(\n toolName: string,\n propertyName: string,\n value: unknown,\n schema: Record<string, unknown>,\n toolLabel: string,\n): void {\n const enumValues = schema.enum;\n if (\n Array.isArray(enumValues) &&\n !enumValues.some((item) => Object.is(item, value))\n ) {\n throw new Error(\n `${toolLabel} \"${toolName}\" arguments failed schema validation: property \"${propertyName}\" must be one of ${formatEnumValues(enumValues)}`,\n );\n }\n\n const expectedType = schema.type;\n if (typeof expectedType !== \"string\") {\n return;\n }\n\n if (!isSupportedSchemaType(expectedType)) {\n throw new Error(\n `${toolLabel} \"${toolName}\" arguments failed schema validation: property \"${propertyName}\" uses unsupported schema type \"${expectedType}\"`,\n );\n }\n\n if (!matchesSchemaType(value, expectedType)) {\n throw new Error(\n `${toolLabel} \"${toolName}\" arguments failed schema validation: property \"${propertyName}\" must be ${expectedType}`,\n );\n }\n}\n\nfunction matchesSchemaType(value: unknown, expectedType: string): boolean {\n switch (expectedType) {\n case \"string\":\n return typeof value === \"string\";\n case \"number\":\n return typeof value === \"number\" && Number.isFinite(value);\n case \"integer\":\n return typeof value === \"number\" && Number.isInteger(value);\n case \"boolean\":\n return typeof value === \"boolean\";\n case \"object\":\n return isRecord(value) && !Array.isArray(value);\n case \"array\":\n return Array.isArray(value);\n case \"null\":\n return value === null;\n }\n\n return false;\n}\n\nfunction isSupportedSchemaType(expectedType: string): boolean {\n return (\n expectedType === \"string\" ||\n expectedType === \"number\" ||\n expectedType === \"integer\" ||\n expectedType === \"boolean\" ||\n expectedType === \"object\" ||\n expectedType === \"array\" ||\n expectedType === \"null\"\n );\n}\n\nfunction formatEnumValues(values: unknown[]): string {\n return values.map((value) => JSON.stringify(value)).join(\", \");\n}\n\nfunction hasOwnProperty(\n record: Record<string, unknown>,\n propertyName: string,\n): boolean {\n return Object.prototype.hasOwnProperty.call(record, propertyName);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null;\n}\n","import { EventBus } from \"./bus\";\nimport {\n Character,\n Message,\n RenderManager,\n TTSManager,\n STTManager,\n LLMManager,\n} from \"./types\";\nimport { toCharivoError, type CharivoError } from \"./errors\";\n\nexport * from \"./types\";\nexport { EventBus } from \"./bus\";\nexport {\n type BrowserLifecycleCallbacks,\n subscribeBrowserLifecycle,\n} from \"./browser-lifecycle\";\nexport {\n type CharivoErrorCode,\n type CharivoErrorOptions,\n CharivoError,\n CharivoStateError,\n CharivoTimeoutError,\n CharivoTransportError,\n CharivoProviderError,\n CharivoDisposeError,\n type CharivoErrorKind,\n isCharivoError,\n getErrorMessage,\n toCharivoError,\n} from \"./errors\";\nexport {\n createLipSyncAnalyzer,\n type LipSyncAnalyzer,\n type LipSyncAnalyzerOptions,\n} from \"./lipsync-analyzer\";\nexport {\n assertToolResultObject,\n validateToolArguments,\n} from \"./tool-validation\";\n\nexport class Charivo {\n private eventBus: EventBus;\n private llmManager?: LLMManager;\n private renderManager?: RenderManager;\n private ttsManager?: TTSManager;\n private sttManager?: STTManager;\n private realtimeManager?: import(\"./types\").RealtimeManager;\n private character?: Character;\n private isRealtimeMode = false;\n\n constructor() {\n this.eventBus = new EventBus();\n }\n\n /**\n * Attach a render manager to handle character visualization.\n * Automatically connects the event bus and sets the current character if available.\n */\n attachRenderer(renderManager: RenderManager): void {\n // Disconnect the currently-attached manager before replacing it (fixes replace leak)\n if (this.renderManager && this.renderManager !== renderManager) {\n this.renderManager.disconnect();\n }\n\n this.renderManager = renderManager;\n this.connectRenderManagerEventBus(renderManager);\n\n // Set character if it was already configured\n if (this.character) {\n renderManager.setCharacter(this.character);\n }\n }\n\n /**\n * Connects the render manager to the event bus for bidirectional communication.\n */\n private connectRenderManagerEventBus(renderManager: RenderManager): void {\n renderManager.setEventBus(this.eventBus);\n }\n\n /**\n * Attach an LLM manager to handle conversation generation.\n * Automatically sets the current character if available.\n */\n attachLLM(manager: LLMManager): void {\n this.llmManager = manager;\n this.connectLLMManagerEventEmitter(manager);\n\n // Set character if it was already configured\n if (this.character) {\n manager.setCharacter(this.character);\n }\n }\n\n /**\n * Attach a TTS manager to handle voice synthesis.\n * Automatically connects the event emitter for audio events.\n */\n attachTTS(manager: TTSManager): void {\n this.ttsManager = manager;\n this.connectTTSManagerEventEmitter(manager);\n }\n\n /**\n * Detach the TTS manager to disable voice synthesis.\n */\n detachTTS(): void {\n this.ttsManager = undefined;\n }\n\n /**\n * Attach an STT manager to handle speech recognition.\n * Automatically connects the event emitter for STT events.\n */\n attachSTT(manager: STTManager): void {\n this.sttManager = manager;\n this.connectSTTManagerEventEmitter(manager);\n }\n\n /**\n * Detach the STT manager to disable speech recognition.\n */\n detachSTT(): void {\n this.sttManager = undefined;\n }\n\n /**\n * Detach the LLM manager to disable chat completions.\n */\n detachLLM(): void {\n this.llmManager = undefined;\n }\n\n /**\n * Detach the render manager without destroying it.\n */\n detachRenderer(): void {\n this.renderManager?.disconnect();\n this.renderManager = undefined;\n }\n\n /**\n * Connects the TTS manager to the event bus for audio event emission.\n */\n private connectTTSManagerEventEmitter(manager: TTSManager): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Connects the STT manager to the event bus for speech recognition event emission.\n */\n private connectSTTManagerEventEmitter(manager: STTManager): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Connects the LLM manager to the event bus for tool-call event emission.\n */\n private connectLLMManagerEventEmitter(manager: LLMManager): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Set the character for this Charivo instance.\n * Automatically propagates to all attached managers (LLM, Renderer).\n */\n setCharacter(character: Character): void {\n this.character = character;\n\n if (this.llmManager) {\n this.llmManager.setCharacter(character);\n }\n\n if (this.renderManager) {\n this.renderManager.setCharacter(character);\n }\n\n if (this.realtimeManager) {\n this.realtimeManager.setCharacter(character);\n }\n }\n\n /**\n * Process a user message and generate a character response.\n * Orchestrates the full conversation flow: rendering, LLM generation, and TTS playback.\n */\n async userSay(content: string): Promise<void> {\n const userMessage: Message = {\n id: Date.now().toString(),\n content,\n timestamp: new Date(),\n type: \"user\",\n };\n\n this.eventBus.emit(\"message:sent\", { message: userMessage });\n\n // Render user message\n if (this.renderManager) {\n try {\n await this.renderManager.render(userMessage);\n } catch (error) {\n throw toCharivoError(\"state\", error, \"Failed to render user message\");\n }\n }\n\n // Generate and render character response\n if (this.llmManager && this.character) {\n const response = await this.llmManager\n .generateResponse(userMessage)\n .catch((error) =>\n Promise.reject(\n toCharivoError(\n \"provider\",\n error,\n \"Failed to generate a character response\",\n ),\n ),\n );\n\n const characterMessage: Message = {\n id: Date.now().toString() + \"_response\",\n content: response,\n timestamp: new Date(),\n characterId: this.character.id,\n type: \"character\",\n };\n\n this.eventBus.emit(\"message:received\", { message: characterMessage });\n this.eventBus.emit(\"character:speak\", {\n character: this.character,\n message: response,\n });\n\n if (this.renderManager) {\n try {\n await this.renderManager.render(characterMessage, this.character);\n } catch (error) {\n throw toCharivoError(\n \"state\",\n error,\n \"Failed to render character response\",\n );\n }\n }\n\n if (this.ttsManager) {\n try {\n this.eventBus.emit(\"tts:start\", {\n text: response,\n characterId: this.character.id,\n });\n\n const ttsOptions = this.character.voice\n ? {\n rate: this.character.voice.rate,\n pitch: this.character.voice.pitch,\n volume: this.character.voice.volume,\n voice: this.character.voice.voiceId,\n }\n : undefined;\n\n await this.ttsManager.speak(response, ttsOptions);\n this.eventBus.emit(\"tts:end\", { characterId: this.character.id });\n } catch (error) {\n const typedError = toCharivoError(\"provider\", error);\n this.eventBus.emit(\"tts:error\", { error: typedError });\n }\n }\n }\n }\n\n /**\n * Clear the conversation history from the LLM manager.\n */\n clearHistory(): void {\n if (this.llmManager) {\n this.llmManager.clearHistory();\n }\n }\n\n /**\n * Get the conversation history from the LLM manager.\n */\n getHistory(): Message[] {\n return this.llmManager ? this.llmManager.getHistory() : [];\n }\n\n /**\n * Get the currently configured character.\n */\n getCurrentCharacter(): Character | null {\n return this.character ?? null;\n }\n\n /**\n * Get the current STT manager instance.\n */\n getSTTManager(): STTManager | undefined {\n return this.sttManager;\n }\n\n /**\n * Get the current render manager instance.\n */\n getRenderManager(): RenderManager | undefined {\n return this.renderManager;\n }\n\n /**\n * Attach a Realtime manager to handle real-time conversation.\n * Automatically connects the event emitter and enables Realtime mode.\n */\n attachRealtime(manager: import(\"./types\").RealtimeManager): void {\n this.realtimeManager = manager;\n this.isRealtimeMode = true;\n this.connectRealtimeManagerEventEmitter(manager);\n\n if (this.character) {\n manager.setCharacter(this.character);\n }\n }\n\n /**\n * Detach the Realtime manager and disable Realtime mode.\n */\n detachRealtime(): void {\n this.realtimeManager = undefined;\n this.isRealtimeMode = false;\n }\n\n /**\n * Check if Realtime mode is enabled.\n */\n isRealtimeModeEnabled(): boolean {\n return this.isRealtimeMode;\n }\n\n /**\n * Connects the Realtime manager to the event bus.\n */\n private connectRealtimeManagerEventEmitter(\n manager: import(\"./types\").RealtimeManager,\n ): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Get the current Realtime manager instance.\n */\n getRealtimeManager(): import(\"./types\").RealtimeManager | undefined {\n return this.realtimeManager;\n }\n\n /**\n * Subscribe to events from the event bus.\n */\n on<K extends keyof import(\"./types\").EventMap>(\n event: K,\n listener: (data: import(\"./types\").EventMap[K]) => void,\n ): void {\n this.eventBus.on(event, listener);\n }\n\n /**\n * Unsubscribe from events from the event bus.\n */\n off<K extends keyof import(\"./types\").EventMap>(\n event: K,\n listener: (data: import(\"./types\").EventMap[K]) => void,\n ): void {\n this.eventBus.off(event, listener);\n }\n\n /**\n * Emit events to the event bus.\n */\n emit<K extends keyof import(\"./types\").EventMap>(\n event: K,\n data: import(\"./types\").EventMap[K],\n ): void {\n this.eventBus.emit(event, data);\n }\n\n async dispose(): Promise<void> {\n let firstError: CharivoError | null = null;\n\n const recordError = (error: unknown, fallbackMessage: string): void => {\n const typedError = toCharivoError(\"dispose\", error, fallbackMessage);\n if (!firstError) {\n firstError = typedError;\n }\n };\n\n if (this.realtimeManager) {\n try {\n await this.realtimeManager.stopSession();\n } catch (error) {\n recordError(error, \"Failed to stop realtime session during dispose\");\n }\n }\n\n if (this.ttsManager) {\n try {\n await this.ttsManager.stop();\n } catch (error) {\n recordError(error, \"Failed to stop TTS during dispose\");\n }\n\n // Runs even when stop() failed: audio resources must still be released.\n try {\n await this.ttsManager.dispose?.();\n } catch (error) {\n recordError(error, \"Failed to release TTS resources during dispose\");\n }\n }\n\n if (this.sttManager) {\n try {\n if (this.sttManager.isRecording()) {\n await this.sttManager.stop();\n }\n } catch (error) {\n recordError(error, \"Failed to stop STT during dispose\");\n }\n }\n\n if (this.renderManager) {\n try {\n await this.renderManager.destroy();\n } catch (error) {\n recordError(error, \"Failed to destroy renderer during dispose\");\n }\n }\n\n if (this.llmManager) {\n try {\n this.llmManager.clearHistory();\n } catch (error) {\n recordError(error, \"Failed to clear LLM history during dispose\");\n }\n }\n\n this.detachRealtime();\n this.detachTTS();\n this.detachSTT();\n this.detachLLM();\n // renderManager was already destroyed+disconnected in the guarded block above;\n // bypass detachRenderer() here to avoid a second disconnect() call.\n this.renderManager = undefined;\n this.character = undefined;\n this.isRealtimeMode = false;\n this.eventBus.clear();\n\n return this.finishDispose(firstError);\n }\n\n private finishDispose(firstError: CharivoError | null): void {\n if (firstError) {\n throw firstError;\n }\n }\n}\n"]}
1
+ {"version":3,"sources":["../src/bus.ts","../src/errors.ts","../src/types.ts","../src/browser-lifecycle.ts","../src/lipsync-analyzer.ts","../src/tool-validation.ts","../src/tool-execution.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import { CharivoEventBus, EventMap } from \"./types\";\n\ntype ListenerStore = {\n [K in keyof EventMap]?: Array<(data: EventMap[K]) => void>;\n};\n\nexport class EventBus implements CharivoEventBus {\n private listeners: ListenerStore = {};\n\n on<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void {\n this.listeners[event] ??= [];\n this.listeners[event]!.push(listener);\n }\n\n emit<K extends keyof EventMap>(event: K, data: EventMap[K]): void {\n // Each listener is isolated: one that throws must not stop the listeners\n // queued behind it, and emit() must stay non-throwing for its callers,\n // which are frequently mid-teardown or inside a provider callback.\n this.listeners[event]?.forEach((listener) => {\n try {\n listener(data);\n } catch (error) {\n console.error(`Event listener for \"${String(event)}\" threw:`, error);\n }\n });\n }\n\n off<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void {\n const eventListeners = this.listeners[event];\n if (!eventListeners) {\n return;\n }\n\n const index = eventListeners.indexOf(listener);\n if (index > -1) {\n eventListeners.splice(index, 1);\n }\n\n if (eventListeners.length === 0) {\n delete this.listeners[event];\n }\n }\n\n clear(): void {\n this.listeners = {};\n }\n}\n","export type CharivoErrorCode =\n | \"CHARIVO_ERROR\"\n | \"CHARIVO_STATE_ERROR\"\n | \"CHARIVO_TIMEOUT_ERROR\"\n | \"CHARIVO_TRANSPORT_ERROR\"\n | \"CHARIVO_PROVIDER_ERROR\"\n | \"CHARIVO_DISPOSE_ERROR\";\n\nexport interface CharivoErrorOptions extends ErrorOptions {\n code?: CharivoErrorCode;\n}\n\nexport class CharivoError extends Error {\n readonly code: CharivoErrorCode;\n\n constructor(message: string, options: CharivoErrorOptions = {}) {\n super(message, options);\n this.name = \"CharivoError\";\n this.code = options.code ?? \"CHARIVO_ERROR\";\n }\n}\n\nexport class CharivoStateError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_STATE_ERROR\",\n });\n this.name = \"CharivoStateError\";\n }\n}\n\nexport class CharivoTimeoutError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_TIMEOUT_ERROR\",\n });\n this.name = \"CharivoTimeoutError\";\n }\n}\n\nexport class CharivoTransportError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_TRANSPORT_ERROR\",\n });\n this.name = \"CharivoTransportError\";\n }\n}\n\nexport class CharivoProviderError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_PROVIDER_ERROR\",\n });\n this.name = \"CharivoProviderError\";\n }\n}\n\nexport class CharivoDisposeError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_DISPOSE_ERROR\",\n });\n this.name = \"CharivoDisposeError\";\n }\n}\n\nexport type CharivoErrorKind =\n | \"state\"\n | \"timeout\"\n | \"transport\"\n | \"provider\"\n | \"dispose\";\n\nexport function isCharivoError(error: unknown): error is CharivoError {\n return error instanceof CharivoError;\n}\n\nexport function getErrorMessage(\n error: unknown,\n fallback = \"Unknown error\",\n): string {\n if (typeof error === \"string\" && error.trim().length > 0) {\n return error;\n }\n\n if (error instanceof Error && error.message.trim().length > 0) {\n return error.message;\n }\n\n return fallback;\n}\n\nexport function toCharivoError(\n kind: CharivoErrorKind,\n error: unknown,\n fallbackMessage?: string,\n): CharivoError {\n if (isCharivoError(error)) {\n return error;\n }\n\n const message = getErrorMessage(error, fallbackMessage);\n const options =\n error instanceof Error\n ? {\n cause: error,\n }\n : undefined;\n\n switch (kind) {\n case \"state\":\n return new CharivoStateError(message, options);\n case \"timeout\":\n return new CharivoTimeoutError(message, options);\n case \"transport\":\n return new CharivoTransportError(message, options);\n case \"provider\":\n return new CharivoProviderError(message, options);\n case \"dispose\":\n return new CharivoDisposeError(message, options);\n }\n}\n","export interface MotionSelection {\n group: string;\n index?: number;\n}\n\nexport interface GazeCoordinates {\n x: number;\n y: number;\n}\n\nexport interface AvatarControlCatalog {\n expressions: string[];\n motions: Record<string, number>;\n}\n\nexport interface Character {\n id: string;\n name: string;\n description?: string;\n personality?: string;\n avatar?: string;\n voice?: {\n voiceId?: string;\n rate?: number;\n pitch?: number;\n volume?: number;\n };\n}\n\nexport interface Message {\n id: string;\n content: string;\n timestamp: Date;\n characterId?: string;\n type: \"user\" | \"character\" | \"system\";\n}\n\nexport interface Conversation {\n id: string;\n messages: Message[];\n characterId?: string;\n createdAt: Date;\n updatedAt: Date;\n}\n\nexport interface Plugin {\n id: string;\n name: string;\n version: string;\n enabled: boolean;\n}\n\nexport interface CharivoConfig {\n characters: Character[];\n plugins: Plugin[];\n llmProvider?: string;\n renderProvider?: string;\n}\n\nexport type RealtimeTransportKind = \"webrtc\" | \"websocket\";\n\nexport type RealtimeToolChoice = \"auto\" | \"none\" | \"required\";\nexport const OPENAI_REALTIME_ADAPTER = \"openai-webrtc\";\nexport const OPENAI_REALTIME_AGENTS_ADAPTER = \"openai-agents-webrtc\";\n\n// Modality-neutral tool contracts (used by realtime and LLM sessions)\nexport interface ToolDefinition {\n type: \"function\";\n name: string;\n description: string;\n /**\n * JSON Schema-shaped. `validateToolArguments` only enforces required-key\n * presence, enum membership, and each property's top-level `type`; nested\n * schemas, `additionalProperties`, and numeric-length constraints are not\n * validated.\n */\n parameters: {\n type: \"object\";\n properties: Record<string, unknown>;\n required?: string[];\n };\n}\n\nexport interface ToolContext {\n character?: Character | null;\n callId?: string;\n /** Present only for realtime sessions. */\n state?: RealtimeState;\n}\n\n/** Must resolve to a plain object; arrays and primitives are rejected by the runners. */\nexport type ToolHandler = (\n args: Record<string, unknown>,\n context: ToolContext,\n) => Promise<Record<string, unknown>>;\n\nexport interface ToolRegistration {\n definition: ToolDefinition;\n handler: ToolHandler;\n /** Timeout in ms; falls back to the manager default when omitted. */\n timeoutMs?: number;\n}\n\nexport interface ToolResultProjectorContext {\n name: string;\n output: Record<string, unknown>;\n callId?: string;\n emit<K extends keyof EventMap>(event: K, payload: EventMap[K]): void;\n}\n\nexport type ToolResultProjector = (context: ToolResultProjectorContext) => void;\n\nexport interface RealtimeSessionConfig {\n provider?: string;\n transport?: RealtimeTransportKind;\n voice?: string;\n model?: string;\n instructions?: string;\n temperature?: number;\n maxTokens?: number;\n tools?: ToolDefinition[];\n toolChoice?: RealtimeToolChoice;\n inputAudioTranscription?: {\n model?: string;\n enabled?: boolean;\n };\n}\n\nexport interface RealtimeSessionRequest {\n adapter?: string;\n transport: RealtimeTransportKind;\n session: RealtimeSessionConfig;\n sdpOffer?: string;\n}\n\nexport type RealtimeSessionBootstrap =\n | {\n adapter: string;\n transport: \"webrtc\";\n answerSdp: string;\n }\n | {\n adapter: string;\n transport: \"webrtc\";\n clientSecret: string;\n }\n | {\n adapter: string;\n transport: \"websocket\";\n url: string;\n token: string;\n };\n\nexport interface RealtimeProvider {\n createSession(\n request: RealtimeSessionRequest,\n ): Promise<RealtimeSessionBootstrap>;\n}\n\nexport type RealtimeConnectionState =\n | \"idle\"\n | \"connecting\"\n | \"connected\"\n | \"disconnecting\"\n | \"error\";\n\nexport type RealtimeReconnectCause =\n | \"ice-disconnected\"\n | \"ice-failed\"\n | \"connection-failed\"\n | \"offline\"\n | \"online\"\n | \"visibility\"\n | \"pagehide\"\n | \"pageshow\";\n\nexport type RealtimeSessionStatus = \"idle\" | \"starting\" | \"active\" | \"stopped\";\nexport type RealtimeSessionTransitionReason = \"user\" | \"refresh\";\n\nexport type RealtimeResponseStatus =\n | \"idle\"\n | \"responding\"\n | \"interrupted\"\n | \"completed\";\n\nexport interface RealtimeState {\n connection: RealtimeConnectionState;\n session: {\n status: RealtimeSessionStatus;\n config: RealtimeSessionConfig | null;\n characterId?: string;\n };\n response: {\n status: RealtimeResponseStatus;\n text: string;\n };\n lastError: Error | null;\n}\n\nexport interface RealtimeUsageEvent {\n usage: Record<string, unknown>;\n model?: string;\n responseId?: string;\n sessionId?: string;\n}\n\nexport interface LLMAdapter {\n generateResponse(message: Message): Promise<string>;\n setCharacter(character: Character): void;\n clearHistory(): void;\n}\n\nexport interface LLMToolCall {\n id: string;\n name: string;\n /** JSON-decoded; the provider/client adapter parses the raw tool-call arguments before this contract is used. */\n arguments: Record<string, unknown>;\n}\n\n/**\n * Role-discriminated union so protocol-invalid combinations are unrepresentable\n * for typed direct callers: unknown roles, tool turns without an ID, and tool\n * calls on user turns cannot be expressed.\n */\nexport type LLMMessage =\n | { role: \"system\" | \"user\"; content: string }\n | { role: \"assistant\"; content: string; toolCalls?: LLMToolCall[] }\n | { role: \"tool\"; content: string; toolCallId: string };\n\nexport interface LLMToolResponse {\n content: string;\n toolCalls?: LLMToolCall[];\n}\n\n// LLM provider (generates LLM responses server-side)\nexport interface LLMProvider {\n generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string>;\n /** Tool-calling variant; providers that support function calling implement this alongside generateResponse. */\n generateResponseWithTools?(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse>;\n}\n\n// Simple LLM call client (stateless)\nexport interface LLMClient {\n call(messages: Array<{ role: string; content: string }>): Promise<string>;\n /** Tool-calling variant; clients that support function calling implement this alongside call. */\n callWithTools?(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse>;\n}\n\n// LLM manager (session management, history, character management)\nexport interface LLMManager {\n setCharacter(character: Character): void;\n getCharacter(): Character | null;\n clearHistory(): void;\n getHistory(): Message[];\n generateResponse(message: Message): Promise<string>;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n registerTool?(tool: ToolRegistration): void;\n unregisterTool?(name: string): void;\n getRegisteredTools?(): ToolDefinition[];\n /** System-prompt-level instructions injected only when tools are registered; pass null to clear. */\n setToolInstructions?(instructions: string | null): void;\n}\n\n/**\n * `LLMManager` with the tool-calling members required instead of optional.\n * Third-party `LLMManager` implementations may omit tool support, but the\n * built-in manager returned by `createLLMManager` always provides it.\n */\nexport interface LLMManagerWithTools extends LLMManager {\n setEventEmitter(eventEmitter: CharivoEventEmitter): void;\n registerTool(tool: ToolRegistration): void;\n unregisterTool(name: string): void;\n getRegisteredTools(): ToolDefinition[];\n setToolInstructions(instructions: string | null): void;\n}\n\n// Renderer interface (stateless renderer)\nexport interface Renderer {\n initialize(): Promise<void>;\n destroy(): Promise<void>;\n render(message: Message, character?: Character): Promise<void>;\n loadModel?(modelPath: string): Promise<void>;\n setRealtimeLipSync?(enabled: boolean): void;\n updateRealtimeLipSyncRms?(rms: number): void;\n playExpression?(expressionId: string): void;\n playMotionByGroup?(group: string, index: number): void;\n lookAt?(coords: GazeCoordinates): void;\n getAvailableExpressions?(): string[];\n getAvailableMotionGroups?(): Record<string, number>;\n}\n\n// Render manager (session management, lip-sync, motion control)\nexport interface RenderManager {\n initialize(): Promise<void>;\n destroy(): Promise<void>;\n setCharacter(character: Character): void;\n render(message: Message, character?: Character): Promise<void>;\n /** Local-presence gaze (webcam), peer of mouse-tracking. Returns true when applied. */\n setLocalGaze?(coords: GazeCoordinates): boolean;\n setEventBus(eventBus: CharivoEventBus): void;\n /** Removes all event-bus listeners registered by setEventBus. */\n disconnect(): void;\n loadModel?(modelPath: string): Promise<void>;\n setMessageCallback?(\n callback: (message: Message, character?: Character) => void,\n ): void;\n}\n\nexport interface TTSOptions {\n rate?: number;\n pitch?: number;\n volume?: number;\n voice?: string;\n}\n\nexport type TTSPlaybackMode = \"audio\" | \"web-speech\";\n\n// TTS player (plays audio in the browser)\nexport interface TTSPlayer {\n /**\n * Explicit playback mode for the manager. Prefer setting this on concrete\n * players instead of relying on constructor-name inference.\n */\n readonly playbackMode?: TTSPlaybackMode;\n /**\n * MIME type used when the manager turns generated audio into a Blob.\n */\n readonly audioMimeType?: string;\n speak(text: string, options?: TTSOptions): Promise<void>;\n stop(): Promise<void>;\n setVoice(voice: string): void;\n isSupported(): boolean;\n /**\n * Stateless audio generation. Required for the `\"audio\"` playback mode: the\n * manager creates the audio element itself so it can analyze playback for\n * lip-sync. Players that can only `speak()` must use `\"web-speech\"` mode.\n */\n generateAudio?(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n}\n\n// TTS provider (generates audio data)\nexport interface TTSProvider {\n generateSpeech(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n setVoice(voice: string): void;\n}\n\n// TTS Manager - interface responsible for managing the state of a TTS session\nexport interface TTSManager {\n speak(text: string, options?: TTSOptions): Promise<void>;\n stop(): Promise<void>;\n setVoice(voice: string): void;\n isSupported(): boolean;\n /** Creates the audio analysis context up front; call from a user gesture handler so browsers allow playback later. */\n prepareAudio?(): Promise<void>;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n /** Final resource release; call stop() first - dispose() does not stop playback. */\n dispose?(): Promise<void>;\n}\n\nexport interface STTOptions {\n language?: string;\n}\n\n// STT provider (converts audio data to text)\nexport interface STTProvider {\n transcribe(audio: Blob | ArrayBuffer, options?: STTOptions): Promise<string>;\n}\n\n// STT transcriber (browser-side audio transcription)\n// Each transcriber handles recording internally\nexport interface STTTranscriber {\n startRecording(options?: STTOptions): Promise<void>;\n stopRecording(): Promise<string>;\n isRecording(): boolean;\n /** Optional: subscribe to cumulative interim transcript snapshots (streaming transcribers only). */\n onPartial?(callback: (transcription: string) => void): void;\n}\n\n// STT Manager - Manages STT session state\nexport interface STTManager {\n start(options?: STTOptions): Promise<void>;\n stop(): Promise<string>;\n isRecording(): boolean;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n}\n\n// Realtime Manager - Manages Realtime API session state\nexport interface RealtimeManager {\n setCharacter(character: Character): void;\n getState(): RealtimeState;\n prepareAudio?(config?: RealtimeSessionConfig): Promise<void>;\n startSession(config?: RealtimeSessionConfig): Promise<void>;\n updateSession(config?: RealtimeSessionConfig): Promise<void>;\n stopSession(): Promise<void>;\n sendMessage(text: string): Promise<void>;\n sendAudioChunk(audio: ArrayBuffer): Promise<void>;\n interrupt(): Promise<void>;\n registerTool(tool: ToolRegistration): void;\n unregisterTool(name: string): void;\n getRegisteredTools(): ToolDefinition[];\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n}\n\nexport type EventMap = {\n \"message:sent\": { message: Message };\n \"message:received\": { message: Message };\n \"character:speak\": { character: Character; message: string };\n \"tts:start\": { text: string; characterId?: string };\n \"tts:end\": { characterId?: string };\n \"tts:error\": { error: Error };\n \"tts:audio:start\": { characterId?: string };\n \"tts:audio:end\": { characterId?: string };\n \"tts:lipsync:update\": { rms: number; characterId?: string };\n \"stt:start\": { options?: STTOptions };\n \"stt:partial\": { text: string };\n \"stt:stop\": { text: string };\n \"stt:error\": { error: Error };\n // Emitted by both the LLM and realtime tool paths.\n \"tool:call\": {\n name: string;\n args: Record<string, unknown>;\n callId?: string;\n };\n \"tool:result\": {\n name: string;\n output: Record<string, unknown>;\n callId?: string;\n };\n \"tool:error\": {\n name: string;\n error: Error;\n callId?: string;\n };\n \"realtime:session:start\": {\n state: RealtimeState;\n reason?: RealtimeSessionTransitionReason;\n };\n \"realtime:session:end\": {\n state: RealtimeState;\n reason?: RealtimeSessionTransitionReason;\n };\n \"realtime:state\": { state: RealtimeState };\n \"realtime:user:transcript\": { text: string };\n \"realtime:assistant:start\": { state: RealtimeState };\n \"realtime:assistant:delta\": { text: string };\n \"realtime:assistant:done\": { text: string };\n \"realtime:reconnect:attempt\": {\n attempt: number;\n delayMs: number;\n cause: RealtimeReconnectCause;\n };\n \"realtime:reconnect:success\": {\n attempts: number;\n totalMs: number;\n cause: RealtimeReconnectCause;\n };\n \"realtime:reconnect:exhausted\": {\n attempts: number;\n totalMs: number;\n cause: RealtimeReconnectCause;\n lastError: Error;\n };\n \"realtime:usage\": RealtimeUsageEvent;\n \"avatar:expression\": { expressionId: string };\n \"avatar:motion\": { group: string; index: number };\n \"avatar:gaze\": GazeCoordinates;\n \"realtime:error\": { error: Error };\n \"llm:error\": { error: Error };\n};\n\nexport interface CharivoEventEmitter {\n emit<K extends keyof EventMap>(event: K, data: EventMap[K]): void;\n}\n\nexport interface CharivoEventBus extends CharivoEventEmitter {\n on<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void;\n off<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void;\n}\n","export interface BrowserLifecycleCallbacks {\n onHidden?(): void;\n onOnline?(): void;\n onPageHide?(event: PageTransitionEvent): void;\n onPageShow?(event: PageTransitionEvent): void;\n onVisible?(): void;\n}\n\nconst subscribers = new Set<BrowserLifecycleCallbacks>();\n\nlet installed = false;\n\nfunction handleVisibilityChange(): void {\n for (const subscriber of subscribers) {\n if (document.visibilityState === \"visible\") {\n subscriber.onVisible?.();\n continue;\n }\n\n subscriber.onHidden?.();\n }\n}\n\nfunction handleOnline(): void {\n for (const subscriber of subscribers) {\n subscriber.onOnline?.();\n }\n}\n\nfunction handlePageHide(event: PageTransitionEvent): void {\n for (const subscriber of subscribers) {\n subscriber.onPageHide?.(event);\n }\n}\n\nfunction handlePageShow(event: PageTransitionEvent): void {\n for (const subscriber of subscribers) {\n subscriber.onPageShow?.(event);\n }\n}\n\nfunction installListeners(): void {\n if (\n installed ||\n typeof window === \"undefined\" ||\n typeof document === \"undefined\"\n ) {\n return;\n }\n\n installed = true;\n document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n window.addEventListener(\"online\", handleOnline);\n window.addEventListener(\"pagehide\", handlePageHide);\n window.addEventListener(\"pageshow\", handlePageShow);\n}\n\nfunction uninstallListeners(): void {\n if (\n !installed ||\n typeof window === \"undefined\" ||\n typeof document === \"undefined\"\n ) {\n return;\n }\n\n installed = false;\n document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n window.removeEventListener(\"online\", handleOnline);\n window.removeEventListener(\"pagehide\", handlePageHide);\n window.removeEventListener(\"pageshow\", handlePageShow);\n}\n\nexport function subscribeBrowserLifecycle(\n callbacks: BrowserLifecycleCallbacks,\n): () => void {\n if (typeof window === \"undefined\" || typeof document === \"undefined\") {\n return () => undefined;\n }\n\n subscribers.add(callbacks);\n installListeners();\n\n return () => {\n subscribers.delete(callbacks);\n if (subscribers.size === 0) {\n uninstallListeners();\n }\n };\n}\n","/**\n * Shared lip sync audio analysis: the single RMS computation used across the repo.\n */\nexport const LIPSYNC_FFT_SIZE = 256;\nexport const LIPSYNC_SMOOTHING_TIME_CONSTANT = 0.8;\n\n/**\n * Compute a mouth-open value from frequency data, focusing on speech frequencies.\n */\nexport function computeLipSyncRms(frequencyData: Uint8Array): number {\n // 10-60% of the spectrum (~2-14kHz at a 48kHz context)\n const speechBandStart = Math.floor(frequencyData.length * 0.1);\n const speechBandEnd = Math.floor(frequencyData.length * 0.6);\n\n let sum = 0;\n for (let index = speechBandStart; index < speechBandEnd; index += 1) {\n const normalized = frequencyData[index] / 255;\n sum += normalized * normalized;\n }\n\n const rms = Math.sqrt(sum / (speechBandEnd - speechBandStart));\n return Math.min(rms * 1.7, 1); // Amplify and clamp\n}\n\nexport interface LipSyncAnalyzerOptions {\n onRms: (rms: number) => void;\n onError?: (error: unknown) => void;\n}\n\nexport interface LipSyncAnalyzer {\n /**\n * Create the AudioContext up front (idempotent).\n */\n prepare(): Promise<void>;\n /**\n * Analyze an audio element while keeping its playback audible.\n */\n attachMediaElement(element: HTMLAudioElement): void;\n /**\n * Analyze a media stream without routing it to the speakers.\n */\n attachMediaStream(stream: MediaStream): void;\n /**\n * Temporarily halt analysis; `resume()` restarts it.\n */\n pause(): void;\n resume(): void;\n /**\n * Halt analysis for the current source. `resume()` no-ops until the next attach.\n */\n stop(): void;\n cleanup(): Promise<void>;\n}\n\nclass LipSyncAnalyzerImpl implements LipSyncAnalyzer {\n private audioContext?: AudioContext;\n private analyser?: AnalyserNode;\n private source?: AudioNode;\n private attachedStream?: MediaStream;\n private dataArray?: Uint8Array<ArrayBuffer>;\n private isActive = false;\n private animationFrameId?: number;\n\n constructor(private options: LipSyncAnalyzerOptions) {}\n\n async prepare(): Promise<void> {\n if (this.audioContext) {\n return;\n }\n\n const audioContextConstructor =\n typeof window === \"undefined\"\n ? undefined\n : window.AudioContext ||\n (window as Window & { webkitAudioContext?: typeof AudioContext })\n .webkitAudioContext;\n if (!audioContextConstructor) {\n throw new Error(\"AudioContext is not supported in this browser\");\n }\n\n this.audioContext = new audioContextConstructor();\n }\n\n attachMediaElement(element: HTMLAudioElement): void {\n this.stop();\n this.resetNodes();\n\n try {\n const audioContext = this.ensureAudioContext();\n if (!audioContext) {\n return;\n }\n\n const analyser = this.createAnalyser(audioContext);\n const source = audioContext.createMediaElementSource(element);\n source.connect(analyser);\n analyser.connect(audioContext.destination); // Keep playback audible\n\n this.startAnalysis(source, analyser);\n\n // Resume audio context if suspended (required on some browsers)\n if (audioContext.state === \"suspended\") {\n element.addEventListener(\n \"play\",\n () => {\n this.audioContext?.resume();\n },\n { once: true },\n );\n }\n } catch (error) {\n this.options.onError?.(error);\n }\n }\n\n attachMediaStream(stream: MediaStream): void {\n if (this.attachedStream === stream) {\n return;\n }\n\n this.stop();\n this.resetNodes();\n\n try {\n const audioContext = this.ensureAudioContext();\n if (!audioContext) {\n return;\n }\n\n const analyser = this.createAnalyser(audioContext);\n const source = audioContext.createMediaStreamSource(stream);\n source.connect(analyser); // Not connected to the destination: the stream is already audible\n\n this.startAnalysis(source, analyser);\n\n // Memoize only after success so a failed attach stays retryable\n this.attachedStream = stream;\n } catch (error) {\n this.options.onError?.(error);\n }\n }\n\n pause(): void {\n this.cancelLoop();\n this.options.onRms(0);\n }\n\n resume(): void {\n if (\n !this.isActive ||\n this.animationFrameId !== undefined ||\n !this.analyser ||\n !this.dataArray\n ) {\n return;\n }\n\n this.analyzeFrame();\n }\n\n stop(): void {\n this.isActive = false;\n this.attachedStream = undefined;\n this.cancelLoop();\n this.options.onRms(0); // Reset mouth to closed position\n }\n\n async cleanup(): Promise<void> {\n // Clear every reference synchronously so a prepare() racing an in-flight\n // close() creates a fresh context instead of reusing the closing one.\n this.stop();\n this.resetNodes();\n this.dataArray = undefined;\n\n const audioContext = this.audioContext;\n this.audioContext = undefined;\n\n await audioContext?.close();\n }\n\n /**\n * Create the context lazily so callers can attach without awaiting prepare().\n *\n * This relies on prepare() staying await-free before it assigns\n * `this.audioContext`: the void call below runs its body synchronously, so\n * the context is already visible when this returns on the same tick.\n */\n private ensureAudioContext(): AudioContext | undefined {\n if (!this.audioContext) {\n void this.prepare().catch((error) => {\n this.options.onError?.(error);\n });\n }\n\n return this.audioContext;\n }\n\n private createAnalyser(audioContext: AudioContext): AnalyserNode {\n const analyser = audioContext.createAnalyser();\n analyser.fftSize = LIPSYNC_FFT_SIZE;\n analyser.smoothingTimeConstant = LIPSYNC_SMOOTHING_TIME_CONSTANT;\n return analyser;\n }\n\n private startAnalysis(source: AudioNode, analyser: AnalyserNode): void {\n this.source = source;\n this.analyser = analyser;\n this.dataArray = new Uint8Array(analyser.frequencyBinCount);\n this.isActive = true;\n this.analyzeFrame();\n }\n\n private analyzeFrame(): void {\n if (!this.isActive || !this.analyser || !this.dataArray) {\n return;\n }\n\n this.analyser.getByteFrequencyData(this.dataArray);\n this.options.onRms(computeLipSyncRms(this.dataArray));\n\n this.animationFrameId = requestAnimationFrame(() => this.analyzeFrame());\n }\n\n private cancelLoop(): void {\n if (this.animationFrameId !== undefined) {\n cancelAnimationFrame(this.animationFrameId);\n this.animationFrameId = undefined;\n }\n }\n\n private resetNodes(): void {\n if (this.source) {\n this.source.disconnect();\n this.source = undefined;\n }\n\n if (this.analyser) {\n this.analyser.disconnect();\n this.analyser = undefined;\n }\n }\n}\n\nexport function createLipSyncAnalyzer(\n options: LipSyncAnalyzerOptions,\n): LipSyncAnalyzer {\n return new LipSyncAnalyzerImpl(options);\n}\n","/**\n * Shared tool validation: the single argument/result contract enforced before\n * and after a tool handler runs, regardless of the modality that calls it.\n *\n * Errors here are plain `Error`, not a `CharivoErrorKind` variant, on purpose:\n * this preserves message-string compatibility with the pre-move realtime\n * validator, and no existing error kind fits schema validation.\n */\nimport type { ToolDefinition } from \"./types\";\n\n/**\n * Validates tool call arguments against a definition's parameter schema.\n *\n * Enforces only: required-key presence, `enum` membership, and each\n * property's top-level `type`. Nested schemas, `additionalProperties`, and\n * numeric-length constraints (`minLength`, `maximum`, etc.) are not\n * validated. Throws a plain `Error` on the first violation found.\n *\n * @param toolLabel - Prefixes thrown messages (e.g. `${toolLabel} \"name\" ...`);\n * callers use this to distinguish realtime tools from other modalities.\n */\nexport function validateToolArguments(\n definition: ToolDefinition,\n args: unknown,\n toolLabel = \"Tool\",\n): void {\n if (!isRecord(args) || Array.isArray(args)) {\n throw new Error(\n `${toolLabel} \"${definition.name}\" arguments failed schema validation: arguments must be an object`,\n );\n }\n\n const { parameters } = definition;\n const required = parameters.required ?? [];\n\n for (const propertyName of required) {\n if (!hasOwnProperty(args, propertyName)) {\n throw new Error(\n `${toolLabel} \"${definition.name}\" arguments failed schema validation: missing required property \"${propertyName}\"`,\n );\n }\n }\n\n for (const [propertyName, schema] of Object.entries(parameters.properties)) {\n if (!hasOwnProperty(args, propertyName) || !isRecord(schema)) {\n continue;\n }\n\n validateToolArgumentValue(\n definition.name,\n propertyName,\n args[propertyName],\n schema,\n toolLabel,\n );\n }\n}\n\n/**\n * Tool handlers must resolve to a plain object; arrays and primitives are not\n * serializable tool outputs. Throws a plain `Error` on violation.\n *\n * @param toolLabel - Prefixes the thrown message (e.g. `${toolLabel} \"name\" ...`);\n * callers use this to distinguish realtime tools from other modalities.\n */\nexport function assertToolResultObject(\n result: unknown,\n toolName: string,\n toolLabel = \"Tool\",\n): asserts result is Record<string, unknown> {\n if (!isRecord(result) || Array.isArray(result)) {\n throw new Error(`${toolLabel} \"${toolName}\" must return an object`);\n }\n}\n\nfunction validateToolArgumentValue(\n toolName: string,\n propertyName: string,\n value: unknown,\n schema: Record<string, unknown>,\n toolLabel: string,\n): void {\n const enumValues = schema.enum;\n if (\n Array.isArray(enumValues) &&\n !enumValues.some((item) => Object.is(item, value))\n ) {\n throw new Error(\n `${toolLabel} \"${toolName}\" arguments failed schema validation: property \"${propertyName}\" must be one of ${formatEnumValues(enumValues)}`,\n );\n }\n\n const expectedType = schema.type;\n if (typeof expectedType !== \"string\") {\n return;\n }\n\n if (!isSupportedSchemaType(expectedType)) {\n throw new Error(\n `${toolLabel} \"${toolName}\" arguments failed schema validation: property \"${propertyName}\" uses unsupported schema type \"${expectedType}\"`,\n );\n }\n\n if (!matchesSchemaType(value, expectedType)) {\n throw new Error(\n `${toolLabel} \"${toolName}\" arguments failed schema validation: property \"${propertyName}\" must be ${expectedType}`,\n );\n }\n}\n\nfunction matchesSchemaType(value: unknown, expectedType: string): boolean {\n switch (expectedType) {\n case \"string\":\n return typeof value === \"string\";\n case \"number\":\n return typeof value === \"number\" && Number.isFinite(value);\n case \"integer\":\n return typeof value === \"number\" && Number.isInteger(value);\n case \"boolean\":\n return typeof value === \"boolean\";\n case \"object\":\n return isRecord(value) && !Array.isArray(value);\n case \"array\":\n return Array.isArray(value);\n case \"null\":\n return value === null;\n }\n\n return false;\n}\n\nfunction isSupportedSchemaType(expectedType: string): boolean {\n return (\n expectedType === \"string\" ||\n expectedType === \"number\" ||\n expectedType === \"integer\" ||\n expectedType === \"boolean\" ||\n expectedType === \"object\" ||\n expectedType === \"array\" ||\n expectedType === \"null\"\n );\n}\n\nfunction formatEnumValues(values: unknown[]): string {\n return values.map((value) => JSON.stringify(value)).join(\", \");\n}\n\nfunction hasOwnProperty(\n record: Record<string, unknown>,\n propertyName: string,\n): boolean {\n return Object.prototype.hasOwnProperty.call(record, propertyName);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null;\n}\n","/**\n * Shared tool-execution plumbing: the registry, timeout, failure-output, and\n * serialization behavior every modality's tool runner needs.\n *\n * Like the validators in `./tool-validation`, each helper takes a `toolLabel`\n * so callers can distinguish realtime tools from other modalities in thrown\n * messages. Errors are plain `Error` for the same reason given there.\n */\nimport type { ToolDefinition, ToolRegistration } from \"./types\";\nimport { assertToolResultObject } from \"./tool-validation\";\n\n/** Registry of the tools a session may execute, keyed by definition name. */\nexport interface ToolRegistry {\n register(tool: ToolRegistration): void;\n unregister(name: string): void;\n get(name: string): ToolRegistration | undefined;\n size(): number;\n /** Deep-copied definitions, safe to hand to a provider without aliasing. */\n getDefinitions(): ToolDefinition[];\n}\n\nexport function createToolRegistry(): ToolRegistry {\n const tools = new Map<string, ToolRegistration>();\n\n return {\n register(tool) {\n tools.set(tool.definition.name, tool);\n },\n\n unregister(name) {\n tools.delete(name);\n },\n\n get(name) {\n return tools.get(name);\n },\n\n size() {\n return tools.size;\n },\n\n getDefinitions() {\n // JSON round-trip rather than a spread: definitions are JSON\n // Schema-shaped and must survive serialization to reach a provider\n // anyway, and a shallow copy would leave nested schemas (an `enum`\n // array, a nested `properties` object) aliased into the registration.\n return Array.from(\n tools.values(),\n (tool) => JSON.parse(JSON.stringify(tool.definition)) as ToolDefinition,\n );\n },\n };\n}\n\n/** Always-serializable output handed back to the model when a tool call fails. */\nexport function createToolFailureOutput(error: Error): Record<string, unknown> {\n return {\n success: false,\n error: error.message,\n };\n}\n\nexport async function withToolTimeout<T>(\n promise: Promise<T>,\n timeoutMs: number,\n toolName: string,\n toolLabel = \"Tool\",\n): Promise<T> {\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n try {\n return await Promise.race([\n promise,\n new Promise<never>((_, reject) => {\n timeoutId = setTimeout(() => {\n reject(\n new Error(\n `${toolLabel} \"${toolName}\" timed out after ${timeoutMs}ms`,\n ),\n );\n }, timeoutMs);\n }),\n ]);\n } finally {\n if (timeoutId !== undefined) {\n clearTimeout(timeoutId);\n }\n }\n}\n\n/**\n * Serializes a tool result, throwing when it cannot be represented as JSON.\n *\n * Package-internal: exported for this module's unit tests only, and\n * deliberately NOT re-exported from the package root. `snapshotToolResult` is\n * the supported entry point — it is the only caller, and callers need the\n * parsed snapshot alongside the string.\n *\n * `JSON.stringify` is declared to return `string`, but it returns the value\n * `undefined` at runtime for inputs whose `toJSON()` yields `undefined` — a\n * case that throws nothing and would otherwise drop the payload silently, so\n * it is checked explicitly rather than relying on a thrown error.\n */\nexport function serializeToolResult(\n result: Record<string, unknown>,\n toolName: string,\n toolLabel = \"Tool\",\n): string {\n const serialized: unknown = JSON.stringify(result);\n\n if (typeof serialized !== \"string\") {\n throw new Error(\n `${toolLabel} \"${toolName}\" result could not be serialized to JSON`,\n );\n }\n\n return serialized;\n}\n\n/** A tool result's JSON string plus the parsed value every consumer sees. */\nexport interface ToolResultSnapshot {\n /** Handed to the model's tool turn, or to the realtime transport. */\n serialized: string;\n /** Parsed form of `serialized` — what `tool:result` and projectors receive. */\n snapshot: Record<string, unknown>;\n}\n\n/**\n * Serializes a tool result once and returns both the string and its parsed\n * snapshot, so every consumer downstream of a tool runner sees the same JSON\n * shape regardless of modality.\n *\n * Call this inside a tool runner's failure boundary: a result that cannot be\n * represented as JSON throws here and degrades to a failure output instead of\n * reaching a transport or a projector. Serializing proves the result is\n * representable, but a `toJSON()` can still yield null, an array, or a\n * primitive, so the parsed value is checked against the tool-result contract\n * rather than cast to it.\n */\nexport function snapshotToolResult(\n result: Record<string, unknown>,\n toolName: string,\n toolLabel = \"Tool\",\n): ToolResultSnapshot {\n const serialized = serializeToolResult(result, toolName, toolLabel);\n const parsed: unknown = JSON.parse(serialized);\n\n assertToolResultObject(parsed, toolName, toolLabel);\n\n return { serialized, snapshot: parsed };\n}\n","import { EventBus } from \"./bus\";\nimport {\n Character,\n Message,\n RenderManager,\n TTSManager,\n STTManager,\n LLMManager,\n} from \"./types\";\nimport { toCharivoError, type CharivoError } from \"./errors\";\n\nexport * from \"./types\";\nexport { EventBus } from \"./bus\";\nexport {\n type BrowserLifecycleCallbacks,\n subscribeBrowserLifecycle,\n} from \"./browser-lifecycle\";\nexport {\n type CharivoErrorCode,\n type CharivoErrorOptions,\n CharivoError,\n CharivoStateError,\n CharivoTimeoutError,\n CharivoTransportError,\n CharivoProviderError,\n CharivoDisposeError,\n type CharivoErrorKind,\n isCharivoError,\n getErrorMessage,\n toCharivoError,\n} from \"./errors\";\nexport {\n createLipSyncAnalyzer,\n type LipSyncAnalyzer,\n type LipSyncAnalyzerOptions,\n} from \"./lipsync-analyzer\";\nexport {\n assertToolResultObject,\n validateToolArguments,\n} from \"./tool-validation\";\nexport {\n createToolFailureOutput,\n createToolRegistry,\n snapshotToolResult,\n type ToolRegistry,\n type ToolResultSnapshot,\n withToolTimeout,\n} from \"./tool-execution\";\n\nexport class Charivo {\n private eventBus: EventBus;\n private llmManager?: LLMManager;\n private renderManager?: RenderManager;\n private ttsManager?: TTSManager;\n private sttManager?: STTManager;\n private realtimeManager?: import(\"./types\").RealtimeManager;\n private character?: Character;\n private isRealtimeMode = false;\n\n constructor() {\n this.eventBus = new EventBus();\n }\n\n /**\n * Attach a render manager to handle character visualization.\n * Automatically connects the event bus and sets the current character if available.\n */\n attachRenderer(renderManager: RenderManager): void {\n // Disconnect the currently-attached manager before replacing it (fixes replace leak)\n if (this.renderManager && this.renderManager !== renderManager) {\n this.renderManager.disconnect();\n }\n\n this.renderManager = renderManager;\n this.connectRenderManagerEventBus(renderManager);\n\n // Set character if it was already configured\n if (this.character) {\n renderManager.setCharacter(this.character);\n }\n }\n\n /**\n * Connects the render manager to the event bus for bidirectional communication.\n */\n private connectRenderManagerEventBus(renderManager: RenderManager): void {\n renderManager.setEventBus(this.eventBus);\n }\n\n /**\n * Attach an LLM manager to handle conversation generation.\n * Automatically sets the current character if available.\n */\n attachLLM(manager: LLMManager): void {\n this.llmManager = manager;\n this.connectLLMManagerEventEmitter(manager);\n\n // Set character if it was already configured\n if (this.character) {\n manager.setCharacter(this.character);\n }\n }\n\n /**\n * Attach a TTS manager to handle voice synthesis.\n * Automatically connects the event emitter for audio events.\n */\n attachTTS(manager: TTSManager): void {\n this.ttsManager = manager;\n this.connectTTSManagerEventEmitter(manager);\n }\n\n /**\n * Detach the TTS manager to disable voice synthesis.\n */\n detachTTS(): void {\n this.ttsManager = undefined;\n }\n\n /**\n * Attach an STT manager to handle speech recognition.\n * Automatically connects the event emitter for STT events.\n */\n attachSTT(manager: STTManager): void {\n this.sttManager = manager;\n this.connectSTTManagerEventEmitter(manager);\n }\n\n /**\n * Detach the STT manager to disable speech recognition.\n */\n detachSTT(): void {\n this.sttManager = undefined;\n }\n\n /**\n * Detach the LLM manager to disable chat completions.\n */\n detachLLM(): void {\n this.llmManager = undefined;\n }\n\n /**\n * Detach the render manager without destroying it.\n */\n detachRenderer(): void {\n this.renderManager?.disconnect();\n this.renderManager = undefined;\n }\n\n /**\n * Connects the TTS manager to the event bus for audio event emission.\n */\n private connectTTSManagerEventEmitter(manager: TTSManager): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Connects the STT manager to the event bus for speech recognition event emission.\n */\n private connectSTTManagerEventEmitter(manager: STTManager): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Connects the LLM manager to the event bus for tool-call event emission.\n */\n private connectLLMManagerEventEmitter(manager: LLMManager): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Set the character for this Charivo instance.\n * Automatically propagates to all attached managers (LLM, Renderer).\n */\n setCharacter(character: Character): void {\n this.character = character;\n\n if (this.llmManager) {\n this.llmManager.setCharacter(character);\n }\n\n if (this.renderManager) {\n this.renderManager.setCharacter(character);\n }\n\n if (this.realtimeManager) {\n this.realtimeManager.setCharacter(character);\n }\n }\n\n /**\n * Process a user message and generate a character response.\n * Orchestrates the full conversation flow: rendering, LLM generation, and TTS playback.\n */\n async userSay(content: string): Promise<void> {\n const userMessage: Message = {\n id: Date.now().toString(),\n content,\n timestamp: new Date(),\n type: \"user\",\n };\n\n this.eventBus.emit(\"message:sent\", { message: userMessage });\n\n // Render user message\n if (this.renderManager) {\n try {\n await this.renderManager.render(userMessage);\n } catch (error) {\n throw toCharivoError(\"state\", error, \"Failed to render user message\");\n }\n }\n\n // Generate and render character response\n if (this.llmManager && this.character) {\n const response = await this.llmManager\n .generateResponse(userMessage)\n .catch((error) =>\n Promise.reject(\n toCharivoError(\n \"provider\",\n error,\n \"Failed to generate a character response\",\n ),\n ),\n );\n\n const characterMessage: Message = {\n id: Date.now().toString() + \"_response\",\n content: response,\n timestamp: new Date(),\n characterId: this.character.id,\n type: \"character\",\n };\n\n this.eventBus.emit(\"message:received\", { message: characterMessage });\n this.eventBus.emit(\"character:speak\", {\n character: this.character,\n message: response,\n });\n\n if (this.renderManager) {\n try {\n await this.renderManager.render(characterMessage, this.character);\n } catch (error) {\n throw toCharivoError(\n \"state\",\n error,\n \"Failed to render character response\",\n );\n }\n }\n\n if (this.ttsManager) {\n try {\n this.eventBus.emit(\"tts:start\", {\n text: response,\n characterId: this.character.id,\n });\n\n const ttsOptions = this.character.voice\n ? {\n rate: this.character.voice.rate,\n pitch: this.character.voice.pitch,\n volume: this.character.voice.volume,\n voice: this.character.voice.voiceId,\n }\n : undefined;\n\n await this.ttsManager.speak(response, ttsOptions);\n this.eventBus.emit(\"tts:end\", { characterId: this.character.id });\n } catch (error) {\n const typedError = toCharivoError(\"provider\", error);\n this.eventBus.emit(\"tts:error\", { error: typedError });\n }\n }\n }\n }\n\n /**\n * Clear the conversation history from the LLM manager.\n */\n clearHistory(): void {\n if (this.llmManager) {\n this.llmManager.clearHistory();\n }\n }\n\n /**\n * Get the conversation history from the LLM manager.\n */\n getHistory(): Message[] {\n return this.llmManager ? this.llmManager.getHistory() : [];\n }\n\n /**\n * Get the currently configured character.\n */\n getCurrentCharacter(): Character | null {\n return this.character ?? null;\n }\n\n /**\n * Get the current STT manager instance.\n */\n getSTTManager(): STTManager | undefined {\n return this.sttManager;\n }\n\n /**\n * Get the current render manager instance.\n */\n getRenderManager(): RenderManager | undefined {\n return this.renderManager;\n }\n\n /**\n * Attach a Realtime manager to handle real-time conversation.\n * Automatically connects the event emitter and enables Realtime mode.\n */\n attachRealtime(manager: import(\"./types\").RealtimeManager): void {\n this.realtimeManager = manager;\n this.isRealtimeMode = true;\n this.connectRealtimeManagerEventEmitter(manager);\n\n if (this.character) {\n manager.setCharacter(this.character);\n }\n }\n\n /**\n * Detach the Realtime manager and disable Realtime mode.\n */\n detachRealtime(): void {\n this.realtimeManager = undefined;\n this.isRealtimeMode = false;\n }\n\n /**\n * Check if Realtime mode is enabled.\n */\n isRealtimeModeEnabled(): boolean {\n return this.isRealtimeMode;\n }\n\n /**\n * Connects the Realtime manager to the event bus.\n */\n private connectRealtimeManagerEventEmitter(\n manager: import(\"./types\").RealtimeManager,\n ): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Get the current Realtime manager instance.\n */\n getRealtimeManager(): import(\"./types\").RealtimeManager | undefined {\n return this.realtimeManager;\n }\n\n /**\n * Subscribe to events from the event bus.\n */\n on<K extends keyof import(\"./types\").EventMap>(\n event: K,\n listener: (data: import(\"./types\").EventMap[K]) => void,\n ): void {\n this.eventBus.on(event, listener);\n }\n\n /**\n * Unsubscribe from events from the event bus.\n */\n off<K extends keyof import(\"./types\").EventMap>(\n event: K,\n listener: (data: import(\"./types\").EventMap[K]) => void,\n ): void {\n this.eventBus.off(event, listener);\n }\n\n /**\n * Emit events to the event bus.\n */\n emit<K extends keyof import(\"./types\").EventMap>(\n event: K,\n data: import(\"./types\").EventMap[K],\n ): void {\n this.eventBus.emit(event, data);\n }\n\n async dispose(): Promise<void> {\n let firstError: CharivoError | null = null;\n\n const recordError = (error: unknown, fallbackMessage: string): void => {\n const typedError = toCharivoError(\"dispose\", error, fallbackMessage);\n if (!firstError) {\n firstError = typedError;\n }\n };\n\n if (this.realtimeManager) {\n try {\n await this.realtimeManager.stopSession();\n } catch (error) {\n recordError(error, \"Failed to stop realtime session during dispose\");\n }\n }\n\n if (this.ttsManager) {\n try {\n await this.ttsManager.stop();\n } catch (error) {\n recordError(error, \"Failed to stop TTS during dispose\");\n }\n\n // Runs even when stop() failed: audio resources must still be released.\n try {\n await this.ttsManager.dispose?.();\n } catch (error) {\n recordError(error, \"Failed to release TTS resources during dispose\");\n }\n }\n\n if (this.sttManager) {\n try {\n if (this.sttManager.isRecording()) {\n await this.sttManager.stop();\n }\n } catch (error) {\n recordError(error, \"Failed to stop STT during dispose\");\n }\n }\n\n if (this.renderManager) {\n try {\n await this.renderManager.destroy();\n } catch (error) {\n recordError(error, \"Failed to destroy renderer during dispose\");\n }\n }\n\n if (this.llmManager) {\n try {\n this.llmManager.clearHistory();\n } catch (error) {\n recordError(error, \"Failed to clear LLM history during dispose\");\n }\n }\n\n this.detachRealtime();\n this.detachTTS();\n this.detachSTT();\n this.detachLLM();\n // renderManager was already destroyed+disconnected in the guarded block above;\n // bypass detachRenderer() here to avoid a second disconnect() call.\n this.renderManager = undefined;\n this.character = undefined;\n this.isRealtimeMode = false;\n this.eventBus.clear();\n\n return this.finishDispose(firstError);\n }\n\n private finishDispose(firstError: CharivoError | null): void {\n if (firstError) {\n throw firstError;\n }\n }\n}\n"]}
package/dist/index.d.cts CHANGED
@@ -363,14 +363,29 @@ type EventMap = {
363
363
  options?: STTOptions;
364
364
  };
365
365
  "stt:partial": {
366
- transcription: string;
366
+ text: string;
367
367
  };
368
368
  "stt:stop": {
369
- transcription: string;
369
+ text: string;
370
370
  };
371
371
  "stt:error": {
372
372
  error: Error;
373
373
  };
374
+ "tool:call": {
375
+ name: string;
376
+ args: Record<string, unknown>;
377
+ callId?: string;
378
+ };
379
+ "tool:result": {
380
+ name: string;
381
+ output: Record<string, unknown>;
382
+ callId?: string;
383
+ };
384
+ "tool:error": {
385
+ name: string;
386
+ error: Error;
387
+ callId?: string;
388
+ };
374
389
  "realtime:session:start": {
375
390
  state: RealtimeState;
376
391
  reason?: RealtimeSessionTransitionReason;
@@ -394,21 +409,6 @@ type EventMap = {
394
409
  "realtime:assistant:done": {
395
410
  text: string;
396
411
  };
397
- "realtime:tool:call": {
398
- name: string;
399
- args: Record<string, unknown>;
400
- callId?: string;
401
- };
402
- "realtime:tool:result": {
403
- name: string;
404
- output: Record<string, unknown>;
405
- callId?: string;
406
- };
407
- "realtime:tool:error": {
408
- name: string;
409
- error: Error;
410
- callId?: string;
411
- };
412
412
  "realtime:reconnect:attempt": {
413
413
  attempt: number;
414
414
  delayMs: number;
@@ -434,13 +434,10 @@ type EventMap = {
434
434
  index: number;
435
435
  };
436
436
  "avatar:gaze": GazeCoordinates;
437
- "realtime:text:delta": {
438
- text: string;
439
- };
440
437
  "realtime:error": {
441
438
  error: Error;
442
439
  };
443
- error: {
440
+ "llm:error": {
444
441
  error: Error;
445
442
  };
446
443
  };
@@ -557,6 +554,49 @@ declare function validateToolArguments(definition: ToolDefinition, args: unknown
557
554
  */
558
555
  declare function assertToolResultObject(result: unknown, toolName: string, toolLabel?: string): asserts result is Record<string, unknown>;
559
556
 
557
+ /**
558
+ * Shared tool-execution plumbing: the registry, timeout, failure-output, and
559
+ * serialization behavior every modality's tool runner needs.
560
+ *
561
+ * Like the validators in `./tool-validation`, each helper takes a `toolLabel`
562
+ * so callers can distinguish realtime tools from other modalities in thrown
563
+ * messages. Errors are plain `Error` for the same reason given there.
564
+ */
565
+
566
+ /** Registry of the tools a session may execute, keyed by definition name. */
567
+ interface ToolRegistry {
568
+ register(tool: ToolRegistration): void;
569
+ unregister(name: string): void;
570
+ get(name: string): ToolRegistration | undefined;
571
+ size(): number;
572
+ /** Deep-copied definitions, safe to hand to a provider without aliasing. */
573
+ getDefinitions(): ToolDefinition[];
574
+ }
575
+ declare function createToolRegistry(): ToolRegistry;
576
+ /** Always-serializable output handed back to the model when a tool call fails. */
577
+ declare function createToolFailureOutput(error: Error): Record<string, unknown>;
578
+ declare function withToolTimeout<T>(promise: Promise<T>, timeoutMs: number, toolName: string, toolLabel?: string): Promise<T>;
579
+ /** A tool result's JSON string plus the parsed value every consumer sees. */
580
+ interface ToolResultSnapshot {
581
+ /** Handed to the model's tool turn, or to the realtime transport. */
582
+ serialized: string;
583
+ /** Parsed form of `serialized` — what `tool:result` and projectors receive. */
584
+ snapshot: Record<string, unknown>;
585
+ }
586
+ /**
587
+ * Serializes a tool result once and returns both the string and its parsed
588
+ * snapshot, so every consumer downstream of a tool runner sees the same JSON
589
+ * shape regardless of modality.
590
+ *
591
+ * Call this inside a tool runner's failure boundary: a result that cannot be
592
+ * represented as JSON throws here and degrades to a failure output instead of
593
+ * reaching a transport or a projector. Serializing proves the result is
594
+ * representable, but a `toJSON()` can still yield null, an array, or a
595
+ * primitive, so the parsed value is checked against the tool-result contract
596
+ * rather than cast to it.
597
+ */
598
+ declare function snapshotToolResult(result: Record<string, unknown>, toolName: string, toolLabel?: string): ToolResultSnapshot;
599
+
560
600
  declare class Charivo {
561
601
  private eventBus;
562
602
  private llmManager?;
@@ -686,4 +726,4 @@ declare class Charivo {
686
726
  private finishDispose;
687
727
  }
688
728
 
689
- export { type AvatarControlCatalog, type BrowserLifecycleCallbacks, type Character, Charivo, type CharivoConfig, CharivoDisposeError, CharivoError, type CharivoErrorCode, type CharivoErrorKind, type CharivoErrorOptions, type CharivoEventBus, type CharivoEventEmitter, CharivoProviderError, CharivoStateError, CharivoTimeoutError, CharivoTransportError, type Conversation, EventBus, type EventMap, type GazeCoordinates, type LLMAdapter, 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 Plugin, 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 ToolResultProjector, type ToolResultProjectorContext, assertToolResultObject, createLipSyncAnalyzer, getErrorMessage, isCharivoError, subscribeBrowserLifecycle, toCharivoError, validateToolArguments };
729
+ export { type AvatarControlCatalog, type BrowserLifecycleCallbacks, type Character, Charivo, type CharivoConfig, CharivoDisposeError, CharivoError, type CharivoErrorCode, type CharivoErrorKind, type CharivoErrorOptions, type CharivoEventBus, type CharivoEventEmitter, CharivoProviderError, CharivoStateError, CharivoTimeoutError, CharivoTransportError, type Conversation, EventBus, type EventMap, type GazeCoordinates, type LLMAdapter, 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 Plugin, 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, createLipSyncAnalyzer, createToolFailureOutput, createToolRegistry, getErrorMessage, isCharivoError, snapshotToolResult, subscribeBrowserLifecycle, toCharivoError, validateToolArguments, withToolTimeout };
package/dist/index.d.ts CHANGED
@@ -363,14 +363,29 @@ type EventMap = {
363
363
  options?: STTOptions;
364
364
  };
365
365
  "stt:partial": {
366
- transcription: string;
366
+ text: string;
367
367
  };
368
368
  "stt:stop": {
369
- transcription: string;
369
+ text: string;
370
370
  };
371
371
  "stt:error": {
372
372
  error: Error;
373
373
  };
374
+ "tool:call": {
375
+ name: string;
376
+ args: Record<string, unknown>;
377
+ callId?: string;
378
+ };
379
+ "tool:result": {
380
+ name: string;
381
+ output: Record<string, unknown>;
382
+ callId?: string;
383
+ };
384
+ "tool:error": {
385
+ name: string;
386
+ error: Error;
387
+ callId?: string;
388
+ };
374
389
  "realtime:session:start": {
375
390
  state: RealtimeState;
376
391
  reason?: RealtimeSessionTransitionReason;
@@ -394,21 +409,6 @@ type EventMap = {
394
409
  "realtime:assistant:done": {
395
410
  text: string;
396
411
  };
397
- "realtime:tool:call": {
398
- name: string;
399
- args: Record<string, unknown>;
400
- callId?: string;
401
- };
402
- "realtime:tool:result": {
403
- name: string;
404
- output: Record<string, unknown>;
405
- callId?: string;
406
- };
407
- "realtime:tool:error": {
408
- name: string;
409
- error: Error;
410
- callId?: string;
411
- };
412
412
  "realtime:reconnect:attempt": {
413
413
  attempt: number;
414
414
  delayMs: number;
@@ -434,13 +434,10 @@ type EventMap = {
434
434
  index: number;
435
435
  };
436
436
  "avatar:gaze": GazeCoordinates;
437
- "realtime:text:delta": {
438
- text: string;
439
- };
440
437
  "realtime:error": {
441
438
  error: Error;
442
439
  };
443
- error: {
440
+ "llm:error": {
444
441
  error: Error;
445
442
  };
446
443
  };
@@ -557,6 +554,49 @@ declare function validateToolArguments(definition: ToolDefinition, args: unknown
557
554
  */
558
555
  declare function assertToolResultObject(result: unknown, toolName: string, toolLabel?: string): asserts result is Record<string, unknown>;
559
556
 
557
+ /**
558
+ * Shared tool-execution plumbing: the registry, timeout, failure-output, and
559
+ * serialization behavior every modality's tool runner needs.
560
+ *
561
+ * Like the validators in `./tool-validation`, each helper takes a `toolLabel`
562
+ * so callers can distinguish realtime tools from other modalities in thrown
563
+ * messages. Errors are plain `Error` for the same reason given there.
564
+ */
565
+
566
+ /** Registry of the tools a session may execute, keyed by definition name. */
567
+ interface ToolRegistry {
568
+ register(tool: ToolRegistration): void;
569
+ unregister(name: string): void;
570
+ get(name: string): ToolRegistration | undefined;
571
+ size(): number;
572
+ /** Deep-copied definitions, safe to hand to a provider without aliasing. */
573
+ getDefinitions(): ToolDefinition[];
574
+ }
575
+ declare function createToolRegistry(): ToolRegistry;
576
+ /** Always-serializable output handed back to the model when a tool call fails. */
577
+ declare function createToolFailureOutput(error: Error): Record<string, unknown>;
578
+ declare function withToolTimeout<T>(promise: Promise<T>, timeoutMs: number, toolName: string, toolLabel?: string): Promise<T>;
579
+ /** A tool result's JSON string plus the parsed value every consumer sees. */
580
+ interface ToolResultSnapshot {
581
+ /** Handed to the model's tool turn, or to the realtime transport. */
582
+ serialized: string;
583
+ /** Parsed form of `serialized` — what `tool:result` and projectors receive. */
584
+ snapshot: Record<string, unknown>;
585
+ }
586
+ /**
587
+ * Serializes a tool result once and returns both the string and its parsed
588
+ * snapshot, so every consumer downstream of a tool runner sees the same JSON
589
+ * shape regardless of modality.
590
+ *
591
+ * Call this inside a tool runner's failure boundary: a result that cannot be
592
+ * represented as JSON throws here and degrades to a failure output instead of
593
+ * reaching a transport or a projector. Serializing proves the result is
594
+ * representable, but a `toJSON()` can still yield null, an array, or a
595
+ * primitive, so the parsed value is checked against the tool-result contract
596
+ * rather than cast to it.
597
+ */
598
+ declare function snapshotToolResult(result: Record<string, unknown>, toolName: string, toolLabel?: string): ToolResultSnapshot;
599
+
560
600
  declare class Charivo {
561
601
  private eventBus;
562
602
  private llmManager?;
@@ -686,4 +726,4 @@ declare class Charivo {
686
726
  private finishDispose;
687
727
  }
688
728
 
689
- export { type AvatarControlCatalog, type BrowserLifecycleCallbacks, type Character, Charivo, type CharivoConfig, CharivoDisposeError, CharivoError, type CharivoErrorCode, type CharivoErrorKind, type CharivoErrorOptions, type CharivoEventBus, type CharivoEventEmitter, CharivoProviderError, CharivoStateError, CharivoTimeoutError, CharivoTransportError, type Conversation, EventBus, type EventMap, type GazeCoordinates, type LLMAdapter, 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 Plugin, 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 ToolResultProjector, type ToolResultProjectorContext, assertToolResultObject, createLipSyncAnalyzer, getErrorMessage, isCharivoError, subscribeBrowserLifecycle, toCharivoError, validateToolArguments };
729
+ export { type AvatarControlCatalog, type BrowserLifecycleCallbacks, type Character, Charivo, type CharivoConfig, CharivoDisposeError, CharivoError, type CharivoErrorCode, type CharivoErrorKind, type CharivoErrorOptions, type CharivoEventBus, type CharivoEventEmitter, CharivoProviderError, CharivoStateError, CharivoTimeoutError, CharivoTransportError, type Conversation, EventBus, type EventMap, type GazeCoordinates, type LLMAdapter, 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 Plugin, 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, createLipSyncAnalyzer, createToolFailureOutput, createToolRegistry, getErrorMessage, isCharivoError, snapshotToolResult, subscribeBrowserLifecycle, toCharivoError, validateToolArguments, withToolTimeout };
package/dist/index.js CHANGED
@@ -6,7 +6,13 @@ var EventBus = class {
6
6
  this.listeners[event].push(listener);
7
7
  }
8
8
  emit(event, data) {
9
- this.listeners[event]?.forEach((listener) => listener(data));
9
+ this.listeners[event]?.forEach((listener) => {
10
+ try {
11
+ listener(data);
12
+ } catch (error) {
13
+ console.error(`Event listener for "${String(event)}" threw:`, error);
14
+ }
15
+ });
10
16
  }
11
17
  off(event, listener) {
12
18
  const eventListeners = this.listeners[event];
@@ -429,6 +435,73 @@ function isRecord(value) {
429
435
  return typeof value === "object" && value !== null;
430
436
  }
431
437
 
438
+ // src/tool-execution.ts
439
+ function createToolRegistry() {
440
+ const tools = /* @__PURE__ */ new Map();
441
+ return {
442
+ register(tool) {
443
+ tools.set(tool.definition.name, tool);
444
+ },
445
+ unregister(name) {
446
+ tools.delete(name);
447
+ },
448
+ get(name) {
449
+ return tools.get(name);
450
+ },
451
+ size() {
452
+ return tools.size;
453
+ },
454
+ getDefinitions() {
455
+ return Array.from(
456
+ tools.values(),
457
+ (tool) => JSON.parse(JSON.stringify(tool.definition))
458
+ );
459
+ }
460
+ };
461
+ }
462
+ function createToolFailureOutput(error) {
463
+ return {
464
+ success: false,
465
+ error: error.message
466
+ };
467
+ }
468
+ async function withToolTimeout(promise, timeoutMs, toolName, toolLabel = "Tool") {
469
+ let timeoutId;
470
+ try {
471
+ return await Promise.race([
472
+ promise,
473
+ new Promise((_, reject) => {
474
+ timeoutId = setTimeout(() => {
475
+ reject(
476
+ new Error(
477
+ `${toolLabel} "${toolName}" timed out after ${timeoutMs}ms`
478
+ )
479
+ );
480
+ }, timeoutMs);
481
+ })
482
+ ]);
483
+ } finally {
484
+ if (timeoutId !== void 0) {
485
+ clearTimeout(timeoutId);
486
+ }
487
+ }
488
+ }
489
+ function serializeToolResult(result, toolName, toolLabel = "Tool") {
490
+ const serialized = JSON.stringify(result);
491
+ if (typeof serialized !== "string") {
492
+ throw new Error(
493
+ `${toolLabel} "${toolName}" result could not be serialized to JSON`
494
+ );
495
+ }
496
+ return serialized;
497
+ }
498
+ function snapshotToolResult(result, toolName, toolLabel = "Tool") {
499
+ const serialized = serializeToolResult(result, toolName, toolLabel);
500
+ const parsed = JSON.parse(serialized);
501
+ assertToolResultObject(parsed, toolName, toolLabel);
502
+ return { serialized, snapshot: parsed };
503
+ }
504
+
432
505
  // src/index.ts
433
506
  var Charivo = class {
434
507
  eventBus;
@@ -783,6 +856,6 @@ var Charivo = class {
783
856
  }
784
857
  };
785
858
 
786
- export { Charivo, CharivoDisposeError, CharivoError, CharivoProviderError, CharivoStateError, CharivoTimeoutError, CharivoTransportError, EventBus, OPENAI_REALTIME_ADAPTER, OPENAI_REALTIME_AGENTS_ADAPTER, assertToolResultObject, createLipSyncAnalyzer, getErrorMessage, isCharivoError, subscribeBrowserLifecycle, toCharivoError, validateToolArguments };
859
+ export { Charivo, CharivoDisposeError, CharivoError, CharivoProviderError, CharivoStateError, CharivoTimeoutError, CharivoTransportError, EventBus, OPENAI_REALTIME_ADAPTER, OPENAI_REALTIME_AGENTS_ADAPTER, assertToolResultObject, createLipSyncAnalyzer, createToolFailureOutput, createToolRegistry, getErrorMessage, isCharivoError, snapshotToolResult, subscribeBrowserLifecycle, toCharivoError, validateToolArguments, withToolTimeout };
787
860
  //# sourceMappingURL=index.js.map
788
861
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/bus.ts","../src/errors.ts","../src/types.ts","../src/browser-lifecycle.ts","../src/lipsync-analyzer.ts","../src/tool-validation.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { CharivoEventBus, EventMap } from \"./types\";\n\ntype ListenerStore = {\n [K in keyof EventMap]?: Array<(data: EventMap[K]) => void>;\n};\n\nexport class EventBus implements CharivoEventBus {\n private listeners: ListenerStore = {};\n\n on<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void {\n this.listeners[event] ??= [];\n this.listeners[event]!.push(listener);\n }\n\n emit<K extends keyof EventMap>(event: K, data: EventMap[K]): void {\n this.listeners[event]?.forEach((listener) => listener(data));\n }\n\n off<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void {\n const eventListeners = this.listeners[event];\n if (!eventListeners) {\n return;\n }\n\n const index = eventListeners.indexOf(listener);\n if (index > -1) {\n eventListeners.splice(index, 1);\n }\n\n if (eventListeners.length === 0) {\n delete this.listeners[event];\n }\n }\n\n clear(): void {\n this.listeners = {};\n }\n}\n","export type CharivoErrorCode =\n | \"CHARIVO_ERROR\"\n | \"CHARIVO_STATE_ERROR\"\n | \"CHARIVO_TIMEOUT_ERROR\"\n | \"CHARIVO_TRANSPORT_ERROR\"\n | \"CHARIVO_PROVIDER_ERROR\"\n | \"CHARIVO_DISPOSE_ERROR\";\n\nexport interface CharivoErrorOptions extends ErrorOptions {\n code?: CharivoErrorCode;\n}\n\nexport class CharivoError extends Error {\n readonly code: CharivoErrorCode;\n\n constructor(message: string, options: CharivoErrorOptions = {}) {\n super(message, options);\n this.name = \"CharivoError\";\n this.code = options.code ?? \"CHARIVO_ERROR\";\n }\n}\n\nexport class CharivoStateError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_STATE_ERROR\",\n });\n this.name = \"CharivoStateError\";\n }\n}\n\nexport class CharivoTimeoutError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_TIMEOUT_ERROR\",\n });\n this.name = \"CharivoTimeoutError\";\n }\n}\n\nexport class CharivoTransportError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_TRANSPORT_ERROR\",\n });\n this.name = \"CharivoTransportError\";\n }\n}\n\nexport class CharivoProviderError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_PROVIDER_ERROR\",\n });\n this.name = \"CharivoProviderError\";\n }\n}\n\nexport class CharivoDisposeError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_DISPOSE_ERROR\",\n });\n this.name = \"CharivoDisposeError\";\n }\n}\n\nexport type CharivoErrorKind =\n | \"state\"\n | \"timeout\"\n | \"transport\"\n | \"provider\"\n | \"dispose\";\n\nexport function isCharivoError(error: unknown): error is CharivoError {\n return error instanceof CharivoError;\n}\n\nexport function getErrorMessage(\n error: unknown,\n fallback = \"Unknown error\",\n): string {\n if (typeof error === \"string\" && error.trim().length > 0) {\n return error;\n }\n\n if (error instanceof Error && error.message.trim().length > 0) {\n return error.message;\n }\n\n return fallback;\n}\n\nexport function toCharivoError(\n kind: CharivoErrorKind,\n error: unknown,\n fallbackMessage?: string,\n): CharivoError {\n if (isCharivoError(error)) {\n return error;\n }\n\n const message = getErrorMessage(error, fallbackMessage);\n const options =\n error instanceof Error\n ? {\n cause: error,\n }\n : undefined;\n\n switch (kind) {\n case \"state\":\n return new CharivoStateError(message, options);\n case \"timeout\":\n return new CharivoTimeoutError(message, options);\n case \"transport\":\n return new CharivoTransportError(message, options);\n case \"provider\":\n return new CharivoProviderError(message, options);\n case \"dispose\":\n return new CharivoDisposeError(message, options);\n }\n}\n","export interface MotionSelection {\n group: string;\n index?: number;\n}\n\nexport interface GazeCoordinates {\n x: number;\n y: number;\n}\n\nexport interface AvatarControlCatalog {\n expressions: string[];\n motions: Record<string, number>;\n}\n\nexport interface Character {\n id: string;\n name: string;\n description?: string;\n personality?: string;\n avatar?: string;\n voice?: {\n voiceId?: string;\n rate?: number;\n pitch?: number;\n volume?: number;\n };\n}\n\nexport interface Message {\n id: string;\n content: string;\n timestamp: Date;\n characterId?: string;\n type: \"user\" | \"character\" | \"system\";\n}\n\nexport interface Conversation {\n id: string;\n messages: Message[];\n characterId?: string;\n createdAt: Date;\n updatedAt: Date;\n}\n\nexport interface Plugin {\n id: string;\n name: string;\n version: string;\n enabled: boolean;\n}\n\nexport interface CharivoConfig {\n characters: Character[];\n plugins: Plugin[];\n llmProvider?: string;\n renderProvider?: string;\n}\n\nexport type RealtimeTransportKind = \"webrtc\" | \"websocket\";\n\nexport type RealtimeToolChoice = \"auto\" | \"none\" | \"required\";\nexport const OPENAI_REALTIME_ADAPTER = \"openai-webrtc\";\nexport const OPENAI_REALTIME_AGENTS_ADAPTER = \"openai-agents-webrtc\";\n\n// Modality-neutral tool contracts (used by realtime and LLM sessions)\nexport interface ToolDefinition {\n type: \"function\";\n name: string;\n description: string;\n /**\n * JSON Schema-shaped. `validateToolArguments` only enforces required-key\n * presence, enum membership, and each property's top-level `type`; nested\n * schemas, `additionalProperties`, and numeric-length constraints are not\n * validated.\n */\n parameters: {\n type: \"object\";\n properties: Record<string, unknown>;\n required?: string[];\n };\n}\n\nexport interface ToolContext {\n character?: Character | null;\n callId?: string;\n /** Present only for realtime sessions. */\n state?: RealtimeState;\n}\n\n/** Must resolve to a plain object; arrays and primitives are rejected by the runners. */\nexport type ToolHandler = (\n args: Record<string, unknown>,\n context: ToolContext,\n) => Promise<Record<string, unknown>>;\n\nexport interface ToolRegistration {\n definition: ToolDefinition;\n handler: ToolHandler;\n /** Timeout in ms; falls back to the manager default when omitted. */\n timeoutMs?: number;\n}\n\nexport interface ToolResultProjectorContext {\n name: string;\n output: Record<string, unknown>;\n callId?: string;\n emit<K extends keyof EventMap>(event: K, payload: EventMap[K]): void;\n}\n\nexport type ToolResultProjector = (context: ToolResultProjectorContext) => void;\n\nexport interface RealtimeSessionConfig {\n provider?: string;\n transport?: RealtimeTransportKind;\n voice?: string;\n model?: string;\n instructions?: string;\n temperature?: number;\n maxTokens?: number;\n tools?: ToolDefinition[];\n toolChoice?: RealtimeToolChoice;\n inputAudioTranscription?: {\n model?: string;\n enabled?: boolean;\n };\n}\n\nexport interface RealtimeSessionRequest {\n adapter?: string;\n transport: RealtimeTransportKind;\n session: RealtimeSessionConfig;\n sdpOffer?: string;\n}\n\nexport type RealtimeSessionBootstrap =\n | {\n adapter: string;\n transport: \"webrtc\";\n answerSdp: string;\n }\n | {\n adapter: string;\n transport: \"webrtc\";\n clientSecret: string;\n }\n | {\n adapter: string;\n transport: \"websocket\";\n url: string;\n token: string;\n };\n\nexport interface RealtimeProvider {\n createSession(\n request: RealtimeSessionRequest,\n ): Promise<RealtimeSessionBootstrap>;\n}\n\nexport type RealtimeConnectionState =\n | \"idle\"\n | \"connecting\"\n | \"connected\"\n | \"disconnecting\"\n | \"error\";\n\nexport type RealtimeReconnectCause =\n | \"ice-disconnected\"\n | \"ice-failed\"\n | \"connection-failed\"\n | \"offline\"\n | \"online\"\n | \"visibility\"\n | \"pagehide\"\n | \"pageshow\";\n\nexport type RealtimeSessionStatus = \"idle\" | \"starting\" | \"active\" | \"stopped\";\nexport type RealtimeSessionTransitionReason = \"user\" | \"refresh\";\n\nexport type RealtimeResponseStatus =\n | \"idle\"\n | \"responding\"\n | \"interrupted\"\n | \"completed\";\n\nexport interface RealtimeState {\n connection: RealtimeConnectionState;\n session: {\n status: RealtimeSessionStatus;\n config: RealtimeSessionConfig | null;\n characterId?: string;\n };\n response: {\n status: RealtimeResponseStatus;\n text: string;\n };\n lastError: Error | null;\n}\n\nexport interface RealtimeUsageEvent {\n usage: Record<string, unknown>;\n model?: string;\n responseId?: string;\n sessionId?: string;\n}\n\nexport interface LLMAdapter {\n generateResponse(message: Message): Promise<string>;\n setCharacter(character: Character): void;\n clearHistory(): void;\n}\n\nexport interface LLMToolCall {\n id: string;\n name: string;\n /** JSON-decoded; the provider/client adapter parses the raw tool-call arguments before this contract is used. */\n arguments: Record<string, unknown>;\n}\n\n/**\n * Role-discriminated union so protocol-invalid combinations are unrepresentable\n * for typed direct callers: unknown roles, tool turns without an ID, and tool\n * calls on user turns cannot be expressed.\n */\nexport type LLMMessage =\n | { role: \"system\" | \"user\"; content: string }\n | { role: \"assistant\"; content: string; toolCalls?: LLMToolCall[] }\n | { role: \"tool\"; content: string; toolCallId: string };\n\nexport interface LLMToolResponse {\n content: string;\n toolCalls?: LLMToolCall[];\n}\n\n// LLM provider (generates LLM responses server-side)\nexport interface LLMProvider {\n generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string>;\n /** Tool-calling variant; providers that support function calling implement this alongside generateResponse. */\n generateResponseWithTools?(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse>;\n}\n\n// Simple LLM call client (stateless)\nexport interface LLMClient {\n call(messages: Array<{ role: string; content: string }>): Promise<string>;\n /** Tool-calling variant; clients that support function calling implement this alongside call. */\n callWithTools?(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse>;\n}\n\n// LLM manager (session management, history, character management)\nexport interface LLMManager {\n setCharacter(character: Character): void;\n getCharacter(): Character | null;\n clearHistory(): void;\n getHistory(): Message[];\n generateResponse(message: Message): Promise<string>;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n registerTool?(tool: ToolRegistration): void;\n unregisterTool?(name: string): void;\n getRegisteredTools?(): ToolDefinition[];\n /** System-prompt-level instructions injected only when tools are registered; pass null to clear. */\n setToolInstructions?(instructions: string | null): void;\n}\n\n/**\n * `LLMManager` with the tool-calling members required instead of optional.\n * Third-party `LLMManager` implementations may omit tool support, but the\n * built-in manager returned by `createLLMManager` always provides it.\n */\nexport interface LLMManagerWithTools extends LLMManager {\n setEventEmitter(eventEmitter: CharivoEventEmitter): void;\n registerTool(tool: ToolRegistration): void;\n unregisterTool(name: string): void;\n getRegisteredTools(): ToolDefinition[];\n setToolInstructions(instructions: string | null): void;\n}\n\n// Renderer interface (stateless renderer)\nexport interface Renderer {\n initialize(): Promise<void>;\n destroy(): Promise<void>;\n render(message: Message, character?: Character): Promise<void>;\n loadModel?(modelPath: string): Promise<void>;\n setRealtimeLipSync?(enabled: boolean): void;\n updateRealtimeLipSyncRms?(rms: number): void;\n playExpression?(expressionId: string): void;\n playMotionByGroup?(group: string, index: number): void;\n lookAt?(coords: GazeCoordinates): void;\n getAvailableExpressions?(): string[];\n getAvailableMotionGroups?(): Record<string, number>;\n}\n\n// Render manager (session management, lip-sync, motion control)\nexport interface RenderManager {\n initialize(): Promise<void>;\n destroy(): Promise<void>;\n setCharacter(character: Character): void;\n render(message: Message, character?: Character): Promise<void>;\n /** Local-presence gaze (webcam), peer of mouse-tracking. Returns true when applied. */\n setLocalGaze?(coords: GazeCoordinates): boolean;\n setEventBus(eventBus: CharivoEventBus): void;\n /** Removes all event-bus listeners registered by setEventBus. */\n disconnect(): void;\n loadModel?(modelPath: string): Promise<void>;\n setMessageCallback?(\n callback: (message: Message, character?: Character) => void,\n ): void;\n}\n\nexport interface TTSOptions {\n rate?: number;\n pitch?: number;\n volume?: number;\n voice?: string;\n}\n\nexport type TTSPlaybackMode = \"audio\" | \"web-speech\";\n\n// TTS player (plays audio in the browser)\nexport interface TTSPlayer {\n /**\n * Explicit playback mode for the manager. Prefer setting this on concrete\n * players instead of relying on constructor-name inference.\n */\n readonly playbackMode?: TTSPlaybackMode;\n /**\n * MIME type used when the manager turns generated audio into a Blob.\n */\n readonly audioMimeType?: string;\n speak(text: string, options?: TTSOptions): Promise<void>;\n stop(): Promise<void>;\n setVoice(voice: string): void;\n isSupported(): boolean;\n /**\n * Stateless audio generation. Required for the `\"audio\"` playback mode: the\n * manager creates the audio element itself so it can analyze playback for\n * lip-sync. Players that can only `speak()` must use `\"web-speech\"` mode.\n */\n generateAudio?(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n}\n\n// TTS provider (generates audio data)\nexport interface TTSProvider {\n generateSpeech(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n setVoice(voice: string): void;\n}\n\n// TTS Manager - interface responsible for managing the state of a TTS session\nexport interface TTSManager {\n speak(text: string, options?: TTSOptions): Promise<void>;\n stop(): Promise<void>;\n setVoice(voice: string): void;\n isSupported(): boolean;\n /** Creates the audio analysis context up front; call from a user gesture handler so browsers allow playback later. */\n prepareAudio?(): Promise<void>;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n /** Final resource release; call stop() first - dispose() does not stop playback. */\n dispose?(): Promise<void>;\n}\n\nexport interface STTOptions {\n language?: string;\n}\n\n// STT provider (converts audio data to text)\nexport interface STTProvider {\n transcribe(audio: Blob | ArrayBuffer, options?: STTOptions): Promise<string>;\n}\n\n// STT transcriber (browser-side audio transcription)\n// Each transcriber handles recording internally\nexport interface STTTranscriber {\n startRecording(options?: STTOptions): Promise<void>;\n stopRecording(): Promise<string>;\n isRecording(): boolean;\n /** Optional: subscribe to cumulative interim transcript snapshots (streaming transcribers only). */\n onPartial?(callback: (transcription: string) => void): void;\n}\n\n// STT Manager - Manages STT session state\nexport interface STTManager {\n start(options?: STTOptions): Promise<void>;\n stop(): Promise<string>;\n isRecording(): boolean;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n}\n\n// Realtime Manager - Manages Realtime API session state\nexport interface RealtimeManager {\n setCharacter(character: Character): void;\n getState(): RealtimeState;\n prepareAudio?(config?: RealtimeSessionConfig): Promise<void>;\n startSession(config?: RealtimeSessionConfig): Promise<void>;\n updateSession(config?: RealtimeSessionConfig): Promise<void>;\n stopSession(): Promise<void>;\n sendMessage(text: string): Promise<void>;\n sendAudioChunk(audio: ArrayBuffer): Promise<void>;\n interrupt(): Promise<void>;\n registerTool(tool: ToolRegistration): void;\n unregisterTool(name: string): void;\n getRegisteredTools(): ToolDefinition[];\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n}\n\nexport type EventMap = {\n \"message:sent\": { message: Message };\n \"message:received\": { message: Message };\n \"character:speak\": { character: Character; message: string };\n \"tts:start\": { text: string; characterId?: string };\n \"tts:end\": { characterId?: string };\n \"tts:error\": { error: Error };\n \"tts:audio:start\": { characterId?: string };\n \"tts:audio:end\": { characterId?: string };\n \"tts:lipsync:update\": { rms: number; characterId?: string };\n \"stt:start\": { options?: STTOptions };\n \"stt:partial\": { transcription: string };\n \"stt:stop\": { transcription: string };\n \"stt:error\": { error: Error };\n \"realtime:session:start\": {\n state: RealtimeState;\n reason?: RealtimeSessionTransitionReason;\n };\n \"realtime:session:end\": {\n state: RealtimeState;\n reason?: RealtimeSessionTransitionReason;\n };\n \"realtime:state\": { state: RealtimeState };\n \"realtime:user:transcript\": { text: string };\n \"realtime:assistant:start\": { state: RealtimeState };\n \"realtime:assistant:delta\": { text: string };\n \"realtime:assistant:done\": { text: string };\n \"realtime:tool:call\": {\n name: string;\n args: Record<string, unknown>;\n callId?: string;\n };\n \"realtime:tool:result\": {\n name: string;\n output: Record<string, unknown>;\n callId?: string;\n };\n \"realtime:tool:error\": {\n name: string;\n error: Error;\n callId?: string;\n };\n \"realtime:reconnect:attempt\": {\n attempt: number;\n delayMs: number;\n cause: RealtimeReconnectCause;\n };\n \"realtime:reconnect:success\": {\n attempts: number;\n totalMs: number;\n cause: RealtimeReconnectCause;\n };\n \"realtime:reconnect:exhausted\": {\n attempts: number;\n totalMs: number;\n cause: RealtimeReconnectCause;\n lastError: Error;\n };\n \"realtime:usage\": RealtimeUsageEvent;\n \"avatar:expression\": { expressionId: string };\n \"avatar:motion\": { group: string; index: number };\n \"avatar:gaze\": GazeCoordinates;\n \"realtime:text:delta\": { text: string };\n \"realtime:error\": { error: Error };\n error: { error: Error };\n};\n\nexport interface CharivoEventEmitter {\n emit<K extends keyof EventMap>(event: K, data: EventMap[K]): void;\n}\n\nexport interface CharivoEventBus extends CharivoEventEmitter {\n on<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void;\n off<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void;\n}\n","export interface BrowserLifecycleCallbacks {\n onHidden?(): void;\n onOnline?(): void;\n onPageHide?(event: PageTransitionEvent): void;\n onPageShow?(event: PageTransitionEvent): void;\n onVisible?(): void;\n}\n\nconst subscribers = new Set<BrowserLifecycleCallbacks>();\n\nlet installed = false;\n\nfunction handleVisibilityChange(): void {\n for (const subscriber of subscribers) {\n if (document.visibilityState === \"visible\") {\n subscriber.onVisible?.();\n continue;\n }\n\n subscriber.onHidden?.();\n }\n}\n\nfunction handleOnline(): void {\n for (const subscriber of subscribers) {\n subscriber.onOnline?.();\n }\n}\n\nfunction handlePageHide(event: PageTransitionEvent): void {\n for (const subscriber of subscribers) {\n subscriber.onPageHide?.(event);\n }\n}\n\nfunction handlePageShow(event: PageTransitionEvent): void {\n for (const subscriber of subscribers) {\n subscriber.onPageShow?.(event);\n }\n}\n\nfunction installListeners(): void {\n if (\n installed ||\n typeof window === \"undefined\" ||\n typeof document === \"undefined\"\n ) {\n return;\n }\n\n installed = true;\n document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n window.addEventListener(\"online\", handleOnline);\n window.addEventListener(\"pagehide\", handlePageHide);\n window.addEventListener(\"pageshow\", handlePageShow);\n}\n\nfunction uninstallListeners(): void {\n if (\n !installed ||\n typeof window === \"undefined\" ||\n typeof document === \"undefined\"\n ) {\n return;\n }\n\n installed = false;\n document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n window.removeEventListener(\"online\", handleOnline);\n window.removeEventListener(\"pagehide\", handlePageHide);\n window.removeEventListener(\"pageshow\", handlePageShow);\n}\n\nexport function subscribeBrowserLifecycle(\n callbacks: BrowserLifecycleCallbacks,\n): () => void {\n if (typeof window === \"undefined\" || typeof document === \"undefined\") {\n return () => undefined;\n }\n\n subscribers.add(callbacks);\n installListeners();\n\n return () => {\n subscribers.delete(callbacks);\n if (subscribers.size === 0) {\n uninstallListeners();\n }\n };\n}\n","/**\n * Shared lip sync audio analysis: the single RMS computation used across the repo.\n */\nexport const LIPSYNC_FFT_SIZE = 256;\nexport const LIPSYNC_SMOOTHING_TIME_CONSTANT = 0.8;\n\n/**\n * Compute a mouth-open value from frequency data, focusing on speech frequencies.\n */\nexport function computeLipSyncRms(frequencyData: Uint8Array): number {\n // 10-60% of the spectrum (~2-14kHz at a 48kHz context)\n const speechBandStart = Math.floor(frequencyData.length * 0.1);\n const speechBandEnd = Math.floor(frequencyData.length * 0.6);\n\n let sum = 0;\n for (let index = speechBandStart; index < speechBandEnd; index += 1) {\n const normalized = frequencyData[index] / 255;\n sum += normalized * normalized;\n }\n\n const rms = Math.sqrt(sum / (speechBandEnd - speechBandStart));\n return Math.min(rms * 1.7, 1); // Amplify and clamp\n}\n\nexport interface LipSyncAnalyzerOptions {\n onRms: (rms: number) => void;\n onError?: (error: unknown) => void;\n}\n\nexport interface LipSyncAnalyzer {\n /**\n * Create the AudioContext up front (idempotent).\n */\n prepare(): Promise<void>;\n /**\n * Analyze an audio element while keeping its playback audible.\n */\n attachMediaElement(element: HTMLAudioElement): void;\n /**\n * Analyze a media stream without routing it to the speakers.\n */\n attachMediaStream(stream: MediaStream): void;\n /**\n * Temporarily halt analysis; `resume()` restarts it.\n */\n pause(): void;\n resume(): void;\n /**\n * Halt analysis for the current source. `resume()` no-ops until the next attach.\n */\n stop(): void;\n cleanup(): Promise<void>;\n}\n\nclass LipSyncAnalyzerImpl implements LipSyncAnalyzer {\n private audioContext?: AudioContext;\n private analyser?: AnalyserNode;\n private source?: AudioNode;\n private attachedStream?: MediaStream;\n private dataArray?: Uint8Array<ArrayBuffer>;\n private isActive = false;\n private animationFrameId?: number;\n\n constructor(private options: LipSyncAnalyzerOptions) {}\n\n async prepare(): Promise<void> {\n if (this.audioContext) {\n return;\n }\n\n const audioContextConstructor =\n typeof window === \"undefined\"\n ? undefined\n : window.AudioContext ||\n (window as Window & { webkitAudioContext?: typeof AudioContext })\n .webkitAudioContext;\n if (!audioContextConstructor) {\n throw new Error(\"AudioContext is not supported in this browser\");\n }\n\n this.audioContext = new audioContextConstructor();\n }\n\n attachMediaElement(element: HTMLAudioElement): void {\n this.stop();\n this.resetNodes();\n\n try {\n const audioContext = this.ensureAudioContext();\n if (!audioContext) {\n return;\n }\n\n const analyser = this.createAnalyser(audioContext);\n const source = audioContext.createMediaElementSource(element);\n source.connect(analyser);\n analyser.connect(audioContext.destination); // Keep playback audible\n\n this.startAnalysis(source, analyser);\n\n // Resume audio context if suspended (required on some browsers)\n if (audioContext.state === \"suspended\") {\n element.addEventListener(\n \"play\",\n () => {\n this.audioContext?.resume();\n },\n { once: true },\n );\n }\n } catch (error) {\n this.options.onError?.(error);\n }\n }\n\n attachMediaStream(stream: MediaStream): void {\n if (this.attachedStream === stream) {\n return;\n }\n\n this.stop();\n this.resetNodes();\n\n try {\n const audioContext = this.ensureAudioContext();\n if (!audioContext) {\n return;\n }\n\n const analyser = this.createAnalyser(audioContext);\n const source = audioContext.createMediaStreamSource(stream);\n source.connect(analyser); // Not connected to the destination: the stream is already audible\n\n this.startAnalysis(source, analyser);\n\n // Memoize only after success so a failed attach stays retryable\n this.attachedStream = stream;\n } catch (error) {\n this.options.onError?.(error);\n }\n }\n\n pause(): void {\n this.cancelLoop();\n this.options.onRms(0);\n }\n\n resume(): void {\n if (\n !this.isActive ||\n this.animationFrameId !== undefined ||\n !this.analyser ||\n !this.dataArray\n ) {\n return;\n }\n\n this.analyzeFrame();\n }\n\n stop(): void {\n this.isActive = false;\n this.attachedStream = undefined;\n this.cancelLoop();\n this.options.onRms(0); // Reset mouth to closed position\n }\n\n async cleanup(): Promise<void> {\n // Clear every reference synchronously so a prepare() racing an in-flight\n // close() creates a fresh context instead of reusing the closing one.\n this.stop();\n this.resetNodes();\n this.dataArray = undefined;\n\n const audioContext = this.audioContext;\n this.audioContext = undefined;\n\n await audioContext?.close();\n }\n\n /**\n * Create the context lazily so callers can attach without awaiting prepare().\n *\n * This relies on prepare() staying await-free before it assigns\n * `this.audioContext`: the void call below runs its body synchronously, so\n * the context is already visible when this returns on the same tick.\n */\n private ensureAudioContext(): AudioContext | undefined {\n if (!this.audioContext) {\n void this.prepare().catch((error) => {\n this.options.onError?.(error);\n });\n }\n\n return this.audioContext;\n }\n\n private createAnalyser(audioContext: AudioContext): AnalyserNode {\n const analyser = audioContext.createAnalyser();\n analyser.fftSize = LIPSYNC_FFT_SIZE;\n analyser.smoothingTimeConstant = LIPSYNC_SMOOTHING_TIME_CONSTANT;\n return analyser;\n }\n\n private startAnalysis(source: AudioNode, analyser: AnalyserNode): void {\n this.source = source;\n this.analyser = analyser;\n this.dataArray = new Uint8Array(analyser.frequencyBinCount);\n this.isActive = true;\n this.analyzeFrame();\n }\n\n private analyzeFrame(): void {\n if (!this.isActive || !this.analyser || !this.dataArray) {\n return;\n }\n\n this.analyser.getByteFrequencyData(this.dataArray);\n this.options.onRms(computeLipSyncRms(this.dataArray));\n\n this.animationFrameId = requestAnimationFrame(() => this.analyzeFrame());\n }\n\n private cancelLoop(): void {\n if (this.animationFrameId !== undefined) {\n cancelAnimationFrame(this.animationFrameId);\n this.animationFrameId = undefined;\n }\n }\n\n private resetNodes(): void {\n if (this.source) {\n this.source.disconnect();\n this.source = undefined;\n }\n\n if (this.analyser) {\n this.analyser.disconnect();\n this.analyser = undefined;\n }\n }\n}\n\nexport function createLipSyncAnalyzer(\n options: LipSyncAnalyzerOptions,\n): LipSyncAnalyzer {\n return new LipSyncAnalyzerImpl(options);\n}\n","/**\n * Shared tool validation: the single argument/result contract enforced before\n * and after a tool handler runs, regardless of the modality that calls it.\n *\n * Errors here are plain `Error`, not a `CharivoErrorKind` variant, on purpose:\n * this preserves message-string compatibility with the pre-move realtime\n * validator, and no existing error kind fits schema validation.\n */\nimport type { ToolDefinition } from \"./types\";\n\n/**\n * Validates tool call arguments against a definition's parameter schema.\n *\n * Enforces only: required-key presence, `enum` membership, and each\n * property's top-level `type`. Nested schemas, `additionalProperties`, and\n * numeric-length constraints (`minLength`, `maximum`, etc.) are not\n * validated. Throws a plain `Error` on the first violation found.\n *\n * @param toolLabel - Prefixes thrown messages (e.g. `${toolLabel} \"name\" ...`);\n * callers use this to distinguish realtime tools from other modalities.\n */\nexport function validateToolArguments(\n definition: ToolDefinition,\n args: unknown,\n toolLabel = \"Tool\",\n): void {\n if (!isRecord(args) || Array.isArray(args)) {\n throw new Error(\n `${toolLabel} \"${definition.name}\" arguments failed schema validation: arguments must be an object`,\n );\n }\n\n const { parameters } = definition;\n const required = parameters.required ?? [];\n\n for (const propertyName of required) {\n if (!hasOwnProperty(args, propertyName)) {\n throw new Error(\n `${toolLabel} \"${definition.name}\" arguments failed schema validation: missing required property \"${propertyName}\"`,\n );\n }\n }\n\n for (const [propertyName, schema] of Object.entries(parameters.properties)) {\n if (!hasOwnProperty(args, propertyName) || !isRecord(schema)) {\n continue;\n }\n\n validateToolArgumentValue(\n definition.name,\n propertyName,\n args[propertyName],\n schema,\n toolLabel,\n );\n }\n}\n\n/**\n * Tool handlers must resolve to a plain object; arrays and primitives are not\n * serializable tool outputs. Throws a plain `Error` on violation.\n *\n * @param toolLabel - Prefixes the thrown message (e.g. `${toolLabel} \"name\" ...`);\n * callers use this to distinguish realtime tools from other modalities.\n */\nexport function assertToolResultObject(\n result: unknown,\n toolName: string,\n toolLabel = \"Tool\",\n): asserts result is Record<string, unknown> {\n if (!isRecord(result) || Array.isArray(result)) {\n throw new Error(`${toolLabel} \"${toolName}\" must return an object`);\n }\n}\n\nfunction validateToolArgumentValue(\n toolName: string,\n propertyName: string,\n value: unknown,\n schema: Record<string, unknown>,\n toolLabel: string,\n): void {\n const enumValues = schema.enum;\n if (\n Array.isArray(enumValues) &&\n !enumValues.some((item) => Object.is(item, value))\n ) {\n throw new Error(\n `${toolLabel} \"${toolName}\" arguments failed schema validation: property \"${propertyName}\" must be one of ${formatEnumValues(enumValues)}`,\n );\n }\n\n const expectedType = schema.type;\n if (typeof expectedType !== \"string\") {\n return;\n }\n\n if (!isSupportedSchemaType(expectedType)) {\n throw new Error(\n `${toolLabel} \"${toolName}\" arguments failed schema validation: property \"${propertyName}\" uses unsupported schema type \"${expectedType}\"`,\n );\n }\n\n if (!matchesSchemaType(value, expectedType)) {\n throw new Error(\n `${toolLabel} \"${toolName}\" arguments failed schema validation: property \"${propertyName}\" must be ${expectedType}`,\n );\n }\n}\n\nfunction matchesSchemaType(value: unknown, expectedType: string): boolean {\n switch (expectedType) {\n case \"string\":\n return typeof value === \"string\";\n case \"number\":\n return typeof value === \"number\" && Number.isFinite(value);\n case \"integer\":\n return typeof value === \"number\" && Number.isInteger(value);\n case \"boolean\":\n return typeof value === \"boolean\";\n case \"object\":\n return isRecord(value) && !Array.isArray(value);\n case \"array\":\n return Array.isArray(value);\n case \"null\":\n return value === null;\n }\n\n return false;\n}\n\nfunction isSupportedSchemaType(expectedType: string): boolean {\n return (\n expectedType === \"string\" ||\n expectedType === \"number\" ||\n expectedType === \"integer\" ||\n expectedType === \"boolean\" ||\n expectedType === \"object\" ||\n expectedType === \"array\" ||\n expectedType === \"null\"\n );\n}\n\nfunction formatEnumValues(values: unknown[]): string {\n return values.map((value) => JSON.stringify(value)).join(\", \");\n}\n\nfunction hasOwnProperty(\n record: Record<string, unknown>,\n propertyName: string,\n): boolean {\n return Object.prototype.hasOwnProperty.call(record, propertyName);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null;\n}\n","import { EventBus } from \"./bus\";\nimport {\n Character,\n Message,\n RenderManager,\n TTSManager,\n STTManager,\n LLMManager,\n} from \"./types\";\nimport { toCharivoError, type CharivoError } from \"./errors\";\n\nexport * from \"./types\";\nexport { EventBus } from \"./bus\";\nexport {\n type BrowserLifecycleCallbacks,\n subscribeBrowserLifecycle,\n} from \"./browser-lifecycle\";\nexport {\n type CharivoErrorCode,\n type CharivoErrorOptions,\n CharivoError,\n CharivoStateError,\n CharivoTimeoutError,\n CharivoTransportError,\n CharivoProviderError,\n CharivoDisposeError,\n type CharivoErrorKind,\n isCharivoError,\n getErrorMessage,\n toCharivoError,\n} from \"./errors\";\nexport {\n createLipSyncAnalyzer,\n type LipSyncAnalyzer,\n type LipSyncAnalyzerOptions,\n} from \"./lipsync-analyzer\";\nexport {\n assertToolResultObject,\n validateToolArguments,\n} from \"./tool-validation\";\n\nexport class Charivo {\n private eventBus: EventBus;\n private llmManager?: LLMManager;\n private renderManager?: RenderManager;\n private ttsManager?: TTSManager;\n private sttManager?: STTManager;\n private realtimeManager?: import(\"./types\").RealtimeManager;\n private character?: Character;\n private isRealtimeMode = false;\n\n constructor() {\n this.eventBus = new EventBus();\n }\n\n /**\n * Attach a render manager to handle character visualization.\n * Automatically connects the event bus and sets the current character if available.\n */\n attachRenderer(renderManager: RenderManager): void {\n // Disconnect the currently-attached manager before replacing it (fixes replace leak)\n if (this.renderManager && this.renderManager !== renderManager) {\n this.renderManager.disconnect();\n }\n\n this.renderManager = renderManager;\n this.connectRenderManagerEventBus(renderManager);\n\n // Set character if it was already configured\n if (this.character) {\n renderManager.setCharacter(this.character);\n }\n }\n\n /**\n * Connects the render manager to the event bus for bidirectional communication.\n */\n private connectRenderManagerEventBus(renderManager: RenderManager): void {\n renderManager.setEventBus(this.eventBus);\n }\n\n /**\n * Attach an LLM manager to handle conversation generation.\n * Automatically sets the current character if available.\n */\n attachLLM(manager: LLMManager): void {\n this.llmManager = manager;\n this.connectLLMManagerEventEmitter(manager);\n\n // Set character if it was already configured\n if (this.character) {\n manager.setCharacter(this.character);\n }\n }\n\n /**\n * Attach a TTS manager to handle voice synthesis.\n * Automatically connects the event emitter for audio events.\n */\n attachTTS(manager: TTSManager): void {\n this.ttsManager = manager;\n this.connectTTSManagerEventEmitter(manager);\n }\n\n /**\n * Detach the TTS manager to disable voice synthesis.\n */\n detachTTS(): void {\n this.ttsManager = undefined;\n }\n\n /**\n * Attach an STT manager to handle speech recognition.\n * Automatically connects the event emitter for STT events.\n */\n attachSTT(manager: STTManager): void {\n this.sttManager = manager;\n this.connectSTTManagerEventEmitter(manager);\n }\n\n /**\n * Detach the STT manager to disable speech recognition.\n */\n detachSTT(): void {\n this.sttManager = undefined;\n }\n\n /**\n * Detach the LLM manager to disable chat completions.\n */\n detachLLM(): void {\n this.llmManager = undefined;\n }\n\n /**\n * Detach the render manager without destroying it.\n */\n detachRenderer(): void {\n this.renderManager?.disconnect();\n this.renderManager = undefined;\n }\n\n /**\n * Connects the TTS manager to the event bus for audio event emission.\n */\n private connectTTSManagerEventEmitter(manager: TTSManager): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Connects the STT manager to the event bus for speech recognition event emission.\n */\n private connectSTTManagerEventEmitter(manager: STTManager): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Connects the LLM manager to the event bus for tool-call event emission.\n */\n private connectLLMManagerEventEmitter(manager: LLMManager): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Set the character for this Charivo instance.\n * Automatically propagates to all attached managers (LLM, Renderer).\n */\n setCharacter(character: Character): void {\n this.character = character;\n\n if (this.llmManager) {\n this.llmManager.setCharacter(character);\n }\n\n if (this.renderManager) {\n this.renderManager.setCharacter(character);\n }\n\n if (this.realtimeManager) {\n this.realtimeManager.setCharacter(character);\n }\n }\n\n /**\n * Process a user message and generate a character response.\n * Orchestrates the full conversation flow: rendering, LLM generation, and TTS playback.\n */\n async userSay(content: string): Promise<void> {\n const userMessage: Message = {\n id: Date.now().toString(),\n content,\n timestamp: new Date(),\n type: \"user\",\n };\n\n this.eventBus.emit(\"message:sent\", { message: userMessage });\n\n // Render user message\n if (this.renderManager) {\n try {\n await this.renderManager.render(userMessage);\n } catch (error) {\n throw toCharivoError(\"state\", error, \"Failed to render user message\");\n }\n }\n\n // Generate and render character response\n if (this.llmManager && this.character) {\n const response = await this.llmManager\n .generateResponse(userMessage)\n .catch((error) =>\n Promise.reject(\n toCharivoError(\n \"provider\",\n error,\n \"Failed to generate a character response\",\n ),\n ),\n );\n\n const characterMessage: Message = {\n id: Date.now().toString() + \"_response\",\n content: response,\n timestamp: new Date(),\n characterId: this.character.id,\n type: \"character\",\n };\n\n this.eventBus.emit(\"message:received\", { message: characterMessage });\n this.eventBus.emit(\"character:speak\", {\n character: this.character,\n message: response,\n });\n\n if (this.renderManager) {\n try {\n await this.renderManager.render(characterMessage, this.character);\n } catch (error) {\n throw toCharivoError(\n \"state\",\n error,\n \"Failed to render character response\",\n );\n }\n }\n\n if (this.ttsManager) {\n try {\n this.eventBus.emit(\"tts:start\", {\n text: response,\n characterId: this.character.id,\n });\n\n const ttsOptions = this.character.voice\n ? {\n rate: this.character.voice.rate,\n pitch: this.character.voice.pitch,\n volume: this.character.voice.volume,\n voice: this.character.voice.voiceId,\n }\n : undefined;\n\n await this.ttsManager.speak(response, ttsOptions);\n this.eventBus.emit(\"tts:end\", { characterId: this.character.id });\n } catch (error) {\n const typedError = toCharivoError(\"provider\", error);\n this.eventBus.emit(\"tts:error\", { error: typedError });\n }\n }\n }\n }\n\n /**\n * Clear the conversation history from the LLM manager.\n */\n clearHistory(): void {\n if (this.llmManager) {\n this.llmManager.clearHistory();\n }\n }\n\n /**\n * Get the conversation history from the LLM manager.\n */\n getHistory(): Message[] {\n return this.llmManager ? this.llmManager.getHistory() : [];\n }\n\n /**\n * Get the currently configured character.\n */\n getCurrentCharacter(): Character | null {\n return this.character ?? null;\n }\n\n /**\n * Get the current STT manager instance.\n */\n getSTTManager(): STTManager | undefined {\n return this.sttManager;\n }\n\n /**\n * Get the current render manager instance.\n */\n getRenderManager(): RenderManager | undefined {\n return this.renderManager;\n }\n\n /**\n * Attach a Realtime manager to handle real-time conversation.\n * Automatically connects the event emitter and enables Realtime mode.\n */\n attachRealtime(manager: import(\"./types\").RealtimeManager): void {\n this.realtimeManager = manager;\n this.isRealtimeMode = true;\n this.connectRealtimeManagerEventEmitter(manager);\n\n if (this.character) {\n manager.setCharacter(this.character);\n }\n }\n\n /**\n * Detach the Realtime manager and disable Realtime mode.\n */\n detachRealtime(): void {\n this.realtimeManager = undefined;\n this.isRealtimeMode = false;\n }\n\n /**\n * Check if Realtime mode is enabled.\n */\n isRealtimeModeEnabled(): boolean {\n return this.isRealtimeMode;\n }\n\n /**\n * Connects the Realtime manager to the event bus.\n */\n private connectRealtimeManagerEventEmitter(\n manager: import(\"./types\").RealtimeManager,\n ): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Get the current Realtime manager instance.\n */\n getRealtimeManager(): import(\"./types\").RealtimeManager | undefined {\n return this.realtimeManager;\n }\n\n /**\n * Subscribe to events from the event bus.\n */\n on<K extends keyof import(\"./types\").EventMap>(\n event: K,\n listener: (data: import(\"./types\").EventMap[K]) => void,\n ): void {\n this.eventBus.on(event, listener);\n }\n\n /**\n * Unsubscribe from events from the event bus.\n */\n off<K extends keyof import(\"./types\").EventMap>(\n event: K,\n listener: (data: import(\"./types\").EventMap[K]) => void,\n ): void {\n this.eventBus.off(event, listener);\n }\n\n /**\n * Emit events to the event bus.\n */\n emit<K extends keyof import(\"./types\").EventMap>(\n event: K,\n data: import(\"./types\").EventMap[K],\n ): void {\n this.eventBus.emit(event, data);\n }\n\n async dispose(): Promise<void> {\n let firstError: CharivoError | null = null;\n\n const recordError = (error: unknown, fallbackMessage: string): void => {\n const typedError = toCharivoError(\"dispose\", error, fallbackMessage);\n if (!firstError) {\n firstError = typedError;\n }\n };\n\n if (this.realtimeManager) {\n try {\n await this.realtimeManager.stopSession();\n } catch (error) {\n recordError(error, \"Failed to stop realtime session during dispose\");\n }\n }\n\n if (this.ttsManager) {\n try {\n await this.ttsManager.stop();\n } catch (error) {\n recordError(error, \"Failed to stop TTS during dispose\");\n }\n\n // Runs even when stop() failed: audio resources must still be released.\n try {\n await this.ttsManager.dispose?.();\n } catch (error) {\n recordError(error, \"Failed to release TTS resources during dispose\");\n }\n }\n\n if (this.sttManager) {\n try {\n if (this.sttManager.isRecording()) {\n await this.sttManager.stop();\n }\n } catch (error) {\n recordError(error, \"Failed to stop STT during dispose\");\n }\n }\n\n if (this.renderManager) {\n try {\n await this.renderManager.destroy();\n } catch (error) {\n recordError(error, \"Failed to destroy renderer during dispose\");\n }\n }\n\n if (this.llmManager) {\n try {\n this.llmManager.clearHistory();\n } catch (error) {\n recordError(error, \"Failed to clear LLM history during dispose\");\n }\n }\n\n this.detachRealtime();\n this.detachTTS();\n this.detachSTT();\n this.detachLLM();\n // renderManager was already destroyed+disconnected in the guarded block above;\n // bypass detachRenderer() here to avoid a second disconnect() call.\n this.renderManager = undefined;\n this.character = undefined;\n this.isRealtimeMode = false;\n this.eventBus.clear();\n\n return this.finishDispose(firstError);\n }\n\n private finishDispose(firstError: CharivoError | null): void {\n if (firstError) {\n throw firstError;\n }\n }\n}\n"]}
1
+ {"version":3,"sources":["../src/bus.ts","../src/errors.ts","../src/types.ts","../src/browser-lifecycle.ts","../src/lipsync-analyzer.ts","../src/tool-validation.ts","../src/tool-execution.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { CharivoEventBus, EventMap } from \"./types\";\n\ntype ListenerStore = {\n [K in keyof EventMap]?: Array<(data: EventMap[K]) => void>;\n};\n\nexport class EventBus implements CharivoEventBus {\n private listeners: ListenerStore = {};\n\n on<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void {\n this.listeners[event] ??= [];\n this.listeners[event]!.push(listener);\n }\n\n emit<K extends keyof EventMap>(event: K, data: EventMap[K]): void {\n // Each listener is isolated: one that throws must not stop the listeners\n // queued behind it, and emit() must stay non-throwing for its callers,\n // which are frequently mid-teardown or inside a provider callback.\n this.listeners[event]?.forEach((listener) => {\n try {\n listener(data);\n } catch (error) {\n console.error(`Event listener for \"${String(event)}\" threw:`, error);\n }\n });\n }\n\n off<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void {\n const eventListeners = this.listeners[event];\n if (!eventListeners) {\n return;\n }\n\n const index = eventListeners.indexOf(listener);\n if (index > -1) {\n eventListeners.splice(index, 1);\n }\n\n if (eventListeners.length === 0) {\n delete this.listeners[event];\n }\n }\n\n clear(): void {\n this.listeners = {};\n }\n}\n","export type CharivoErrorCode =\n | \"CHARIVO_ERROR\"\n | \"CHARIVO_STATE_ERROR\"\n | \"CHARIVO_TIMEOUT_ERROR\"\n | \"CHARIVO_TRANSPORT_ERROR\"\n | \"CHARIVO_PROVIDER_ERROR\"\n | \"CHARIVO_DISPOSE_ERROR\";\n\nexport interface CharivoErrorOptions extends ErrorOptions {\n code?: CharivoErrorCode;\n}\n\nexport class CharivoError extends Error {\n readonly code: CharivoErrorCode;\n\n constructor(message: string, options: CharivoErrorOptions = {}) {\n super(message, options);\n this.name = \"CharivoError\";\n this.code = options.code ?? \"CHARIVO_ERROR\";\n }\n}\n\nexport class CharivoStateError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_STATE_ERROR\",\n });\n this.name = \"CharivoStateError\";\n }\n}\n\nexport class CharivoTimeoutError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_TIMEOUT_ERROR\",\n });\n this.name = \"CharivoTimeoutError\";\n }\n}\n\nexport class CharivoTransportError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_TRANSPORT_ERROR\",\n });\n this.name = \"CharivoTransportError\";\n }\n}\n\nexport class CharivoProviderError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_PROVIDER_ERROR\",\n });\n this.name = \"CharivoProviderError\";\n }\n}\n\nexport class CharivoDisposeError extends CharivoError {\n constructor(message: string, options: ErrorOptions = {}) {\n super(message, {\n ...options,\n code: \"CHARIVO_DISPOSE_ERROR\",\n });\n this.name = \"CharivoDisposeError\";\n }\n}\n\nexport type CharivoErrorKind =\n | \"state\"\n | \"timeout\"\n | \"transport\"\n | \"provider\"\n | \"dispose\";\n\nexport function isCharivoError(error: unknown): error is CharivoError {\n return error instanceof CharivoError;\n}\n\nexport function getErrorMessage(\n error: unknown,\n fallback = \"Unknown error\",\n): string {\n if (typeof error === \"string\" && error.trim().length > 0) {\n return error;\n }\n\n if (error instanceof Error && error.message.trim().length > 0) {\n return error.message;\n }\n\n return fallback;\n}\n\nexport function toCharivoError(\n kind: CharivoErrorKind,\n error: unknown,\n fallbackMessage?: string,\n): CharivoError {\n if (isCharivoError(error)) {\n return error;\n }\n\n const message = getErrorMessage(error, fallbackMessage);\n const options =\n error instanceof Error\n ? {\n cause: error,\n }\n : undefined;\n\n switch (kind) {\n case \"state\":\n return new CharivoStateError(message, options);\n case \"timeout\":\n return new CharivoTimeoutError(message, options);\n case \"transport\":\n return new CharivoTransportError(message, options);\n case \"provider\":\n return new CharivoProviderError(message, options);\n case \"dispose\":\n return new CharivoDisposeError(message, options);\n }\n}\n","export interface MotionSelection {\n group: string;\n index?: number;\n}\n\nexport interface GazeCoordinates {\n x: number;\n y: number;\n}\n\nexport interface AvatarControlCatalog {\n expressions: string[];\n motions: Record<string, number>;\n}\n\nexport interface Character {\n id: string;\n name: string;\n description?: string;\n personality?: string;\n avatar?: string;\n voice?: {\n voiceId?: string;\n rate?: number;\n pitch?: number;\n volume?: number;\n };\n}\n\nexport interface Message {\n id: string;\n content: string;\n timestamp: Date;\n characterId?: string;\n type: \"user\" | \"character\" | \"system\";\n}\n\nexport interface Conversation {\n id: string;\n messages: Message[];\n characterId?: string;\n createdAt: Date;\n updatedAt: Date;\n}\n\nexport interface Plugin {\n id: string;\n name: string;\n version: string;\n enabled: boolean;\n}\n\nexport interface CharivoConfig {\n characters: Character[];\n plugins: Plugin[];\n llmProvider?: string;\n renderProvider?: string;\n}\n\nexport type RealtimeTransportKind = \"webrtc\" | \"websocket\";\n\nexport type RealtimeToolChoice = \"auto\" | \"none\" | \"required\";\nexport const OPENAI_REALTIME_ADAPTER = \"openai-webrtc\";\nexport const OPENAI_REALTIME_AGENTS_ADAPTER = \"openai-agents-webrtc\";\n\n// Modality-neutral tool contracts (used by realtime and LLM sessions)\nexport interface ToolDefinition {\n type: \"function\";\n name: string;\n description: string;\n /**\n * JSON Schema-shaped. `validateToolArguments` only enforces required-key\n * presence, enum membership, and each property's top-level `type`; nested\n * schemas, `additionalProperties`, and numeric-length constraints are not\n * validated.\n */\n parameters: {\n type: \"object\";\n properties: Record<string, unknown>;\n required?: string[];\n };\n}\n\nexport interface ToolContext {\n character?: Character | null;\n callId?: string;\n /** Present only for realtime sessions. */\n state?: RealtimeState;\n}\n\n/** Must resolve to a plain object; arrays and primitives are rejected by the runners. */\nexport type ToolHandler = (\n args: Record<string, unknown>,\n context: ToolContext,\n) => Promise<Record<string, unknown>>;\n\nexport interface ToolRegistration {\n definition: ToolDefinition;\n handler: ToolHandler;\n /** Timeout in ms; falls back to the manager default when omitted. */\n timeoutMs?: number;\n}\n\nexport interface ToolResultProjectorContext {\n name: string;\n output: Record<string, unknown>;\n callId?: string;\n emit<K extends keyof EventMap>(event: K, payload: EventMap[K]): void;\n}\n\nexport type ToolResultProjector = (context: ToolResultProjectorContext) => void;\n\nexport interface RealtimeSessionConfig {\n provider?: string;\n transport?: RealtimeTransportKind;\n voice?: string;\n model?: string;\n instructions?: string;\n temperature?: number;\n maxTokens?: number;\n tools?: ToolDefinition[];\n toolChoice?: RealtimeToolChoice;\n inputAudioTranscription?: {\n model?: string;\n enabled?: boolean;\n };\n}\n\nexport interface RealtimeSessionRequest {\n adapter?: string;\n transport: RealtimeTransportKind;\n session: RealtimeSessionConfig;\n sdpOffer?: string;\n}\n\nexport type RealtimeSessionBootstrap =\n | {\n adapter: string;\n transport: \"webrtc\";\n answerSdp: string;\n }\n | {\n adapter: string;\n transport: \"webrtc\";\n clientSecret: string;\n }\n | {\n adapter: string;\n transport: \"websocket\";\n url: string;\n token: string;\n };\n\nexport interface RealtimeProvider {\n createSession(\n request: RealtimeSessionRequest,\n ): Promise<RealtimeSessionBootstrap>;\n}\n\nexport type RealtimeConnectionState =\n | \"idle\"\n | \"connecting\"\n | \"connected\"\n | \"disconnecting\"\n | \"error\";\n\nexport type RealtimeReconnectCause =\n | \"ice-disconnected\"\n | \"ice-failed\"\n | \"connection-failed\"\n | \"offline\"\n | \"online\"\n | \"visibility\"\n | \"pagehide\"\n | \"pageshow\";\n\nexport type RealtimeSessionStatus = \"idle\" | \"starting\" | \"active\" | \"stopped\";\nexport type RealtimeSessionTransitionReason = \"user\" | \"refresh\";\n\nexport type RealtimeResponseStatus =\n | \"idle\"\n | \"responding\"\n | \"interrupted\"\n | \"completed\";\n\nexport interface RealtimeState {\n connection: RealtimeConnectionState;\n session: {\n status: RealtimeSessionStatus;\n config: RealtimeSessionConfig | null;\n characterId?: string;\n };\n response: {\n status: RealtimeResponseStatus;\n text: string;\n };\n lastError: Error | null;\n}\n\nexport interface RealtimeUsageEvent {\n usage: Record<string, unknown>;\n model?: string;\n responseId?: string;\n sessionId?: string;\n}\n\nexport interface LLMAdapter {\n generateResponse(message: Message): Promise<string>;\n setCharacter(character: Character): void;\n clearHistory(): void;\n}\n\nexport interface LLMToolCall {\n id: string;\n name: string;\n /** JSON-decoded; the provider/client adapter parses the raw tool-call arguments before this contract is used. */\n arguments: Record<string, unknown>;\n}\n\n/**\n * Role-discriminated union so protocol-invalid combinations are unrepresentable\n * for typed direct callers: unknown roles, tool turns without an ID, and tool\n * calls on user turns cannot be expressed.\n */\nexport type LLMMessage =\n | { role: \"system\" | \"user\"; content: string }\n | { role: \"assistant\"; content: string; toolCalls?: LLMToolCall[] }\n | { role: \"tool\"; content: string; toolCallId: string };\n\nexport interface LLMToolResponse {\n content: string;\n toolCalls?: LLMToolCall[];\n}\n\n// LLM provider (generates LLM responses server-side)\nexport interface LLMProvider {\n generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string>;\n /** Tool-calling variant; providers that support function calling implement this alongside generateResponse. */\n generateResponseWithTools?(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse>;\n}\n\n// Simple LLM call client (stateless)\nexport interface LLMClient {\n call(messages: Array<{ role: string; content: string }>): Promise<string>;\n /** Tool-calling variant; clients that support function calling implement this alongside call. */\n callWithTools?(\n messages: LLMMessage[],\n tools: ToolDefinition[],\n ): Promise<LLMToolResponse>;\n}\n\n// LLM manager (session management, history, character management)\nexport interface LLMManager {\n setCharacter(character: Character): void;\n getCharacter(): Character | null;\n clearHistory(): void;\n getHistory(): Message[];\n generateResponse(message: Message): Promise<string>;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n registerTool?(tool: ToolRegistration): void;\n unregisterTool?(name: string): void;\n getRegisteredTools?(): ToolDefinition[];\n /** System-prompt-level instructions injected only when tools are registered; pass null to clear. */\n setToolInstructions?(instructions: string | null): void;\n}\n\n/**\n * `LLMManager` with the tool-calling members required instead of optional.\n * Third-party `LLMManager` implementations may omit tool support, but the\n * built-in manager returned by `createLLMManager` always provides it.\n */\nexport interface LLMManagerWithTools extends LLMManager {\n setEventEmitter(eventEmitter: CharivoEventEmitter): void;\n registerTool(tool: ToolRegistration): void;\n unregisterTool(name: string): void;\n getRegisteredTools(): ToolDefinition[];\n setToolInstructions(instructions: string | null): void;\n}\n\n// Renderer interface (stateless renderer)\nexport interface Renderer {\n initialize(): Promise<void>;\n destroy(): Promise<void>;\n render(message: Message, character?: Character): Promise<void>;\n loadModel?(modelPath: string): Promise<void>;\n setRealtimeLipSync?(enabled: boolean): void;\n updateRealtimeLipSyncRms?(rms: number): void;\n playExpression?(expressionId: string): void;\n playMotionByGroup?(group: string, index: number): void;\n lookAt?(coords: GazeCoordinates): void;\n getAvailableExpressions?(): string[];\n getAvailableMotionGroups?(): Record<string, number>;\n}\n\n// Render manager (session management, lip-sync, motion control)\nexport interface RenderManager {\n initialize(): Promise<void>;\n destroy(): Promise<void>;\n setCharacter(character: Character): void;\n render(message: Message, character?: Character): Promise<void>;\n /** Local-presence gaze (webcam), peer of mouse-tracking. Returns true when applied. */\n setLocalGaze?(coords: GazeCoordinates): boolean;\n setEventBus(eventBus: CharivoEventBus): void;\n /** Removes all event-bus listeners registered by setEventBus. */\n disconnect(): void;\n loadModel?(modelPath: string): Promise<void>;\n setMessageCallback?(\n callback: (message: Message, character?: Character) => void,\n ): void;\n}\n\nexport interface TTSOptions {\n rate?: number;\n pitch?: number;\n volume?: number;\n voice?: string;\n}\n\nexport type TTSPlaybackMode = \"audio\" | \"web-speech\";\n\n// TTS player (plays audio in the browser)\nexport interface TTSPlayer {\n /**\n * Explicit playback mode for the manager. Prefer setting this on concrete\n * players instead of relying on constructor-name inference.\n */\n readonly playbackMode?: TTSPlaybackMode;\n /**\n * MIME type used when the manager turns generated audio into a Blob.\n */\n readonly audioMimeType?: string;\n speak(text: string, options?: TTSOptions): Promise<void>;\n stop(): Promise<void>;\n setVoice(voice: string): void;\n isSupported(): boolean;\n /**\n * Stateless audio generation. Required for the `\"audio\"` playback mode: the\n * manager creates the audio element itself so it can analyze playback for\n * lip-sync. Players that can only `speak()` must use `\"web-speech\"` mode.\n */\n generateAudio?(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n}\n\n// TTS provider (generates audio data)\nexport interface TTSProvider {\n generateSpeech(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n setVoice(voice: string): void;\n}\n\n// TTS Manager - interface responsible for managing the state of a TTS session\nexport interface TTSManager {\n speak(text: string, options?: TTSOptions): Promise<void>;\n stop(): Promise<void>;\n setVoice(voice: string): void;\n isSupported(): boolean;\n /** Creates the audio analysis context up front; call from a user gesture handler so browsers allow playback later. */\n prepareAudio?(): Promise<void>;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n /** Final resource release; call stop() first - dispose() does not stop playback. */\n dispose?(): Promise<void>;\n}\n\nexport interface STTOptions {\n language?: string;\n}\n\n// STT provider (converts audio data to text)\nexport interface STTProvider {\n transcribe(audio: Blob | ArrayBuffer, options?: STTOptions): Promise<string>;\n}\n\n// STT transcriber (browser-side audio transcription)\n// Each transcriber handles recording internally\nexport interface STTTranscriber {\n startRecording(options?: STTOptions): Promise<void>;\n stopRecording(): Promise<string>;\n isRecording(): boolean;\n /** Optional: subscribe to cumulative interim transcript snapshots (streaming transcribers only). */\n onPartial?(callback: (transcription: string) => void): void;\n}\n\n// STT Manager - Manages STT session state\nexport interface STTManager {\n start(options?: STTOptions): Promise<void>;\n stop(): Promise<string>;\n isRecording(): boolean;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n}\n\n// Realtime Manager - Manages Realtime API session state\nexport interface RealtimeManager {\n setCharacter(character: Character): void;\n getState(): RealtimeState;\n prepareAudio?(config?: RealtimeSessionConfig): Promise<void>;\n startSession(config?: RealtimeSessionConfig): Promise<void>;\n updateSession(config?: RealtimeSessionConfig): Promise<void>;\n stopSession(): Promise<void>;\n sendMessage(text: string): Promise<void>;\n sendAudioChunk(audio: ArrayBuffer): Promise<void>;\n interrupt(): Promise<void>;\n registerTool(tool: ToolRegistration): void;\n unregisterTool(name: string): void;\n getRegisteredTools(): ToolDefinition[];\n setEventEmitter?(eventEmitter: CharivoEventEmitter): void;\n}\n\nexport type EventMap = {\n \"message:sent\": { message: Message };\n \"message:received\": { message: Message };\n \"character:speak\": { character: Character; message: string };\n \"tts:start\": { text: string; characterId?: string };\n \"tts:end\": { characterId?: string };\n \"tts:error\": { error: Error };\n \"tts:audio:start\": { characterId?: string };\n \"tts:audio:end\": { characterId?: string };\n \"tts:lipsync:update\": { rms: number; characterId?: string };\n \"stt:start\": { options?: STTOptions };\n \"stt:partial\": { text: string };\n \"stt:stop\": { text: string };\n \"stt:error\": { error: Error };\n // Emitted by both the LLM and realtime tool paths.\n \"tool:call\": {\n name: string;\n args: Record<string, unknown>;\n callId?: string;\n };\n \"tool:result\": {\n name: string;\n output: Record<string, unknown>;\n callId?: string;\n };\n \"tool:error\": {\n name: string;\n error: Error;\n callId?: string;\n };\n \"realtime:session:start\": {\n state: RealtimeState;\n reason?: RealtimeSessionTransitionReason;\n };\n \"realtime:session:end\": {\n state: RealtimeState;\n reason?: RealtimeSessionTransitionReason;\n };\n \"realtime:state\": { state: RealtimeState };\n \"realtime:user:transcript\": { text: string };\n \"realtime:assistant:start\": { state: RealtimeState };\n \"realtime:assistant:delta\": { text: string };\n \"realtime:assistant:done\": { text: string };\n \"realtime:reconnect:attempt\": {\n attempt: number;\n delayMs: number;\n cause: RealtimeReconnectCause;\n };\n \"realtime:reconnect:success\": {\n attempts: number;\n totalMs: number;\n cause: RealtimeReconnectCause;\n };\n \"realtime:reconnect:exhausted\": {\n attempts: number;\n totalMs: number;\n cause: RealtimeReconnectCause;\n lastError: Error;\n };\n \"realtime:usage\": RealtimeUsageEvent;\n \"avatar:expression\": { expressionId: string };\n \"avatar:motion\": { group: string; index: number };\n \"avatar:gaze\": GazeCoordinates;\n \"realtime:error\": { error: Error };\n \"llm:error\": { error: Error };\n};\n\nexport interface CharivoEventEmitter {\n emit<K extends keyof EventMap>(event: K, data: EventMap[K]): void;\n}\n\nexport interface CharivoEventBus extends CharivoEventEmitter {\n on<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void;\n off<K extends keyof EventMap>(\n event: K,\n listener: (data: EventMap[K]) => void,\n ): void;\n}\n","export interface BrowserLifecycleCallbacks {\n onHidden?(): void;\n onOnline?(): void;\n onPageHide?(event: PageTransitionEvent): void;\n onPageShow?(event: PageTransitionEvent): void;\n onVisible?(): void;\n}\n\nconst subscribers = new Set<BrowserLifecycleCallbacks>();\n\nlet installed = false;\n\nfunction handleVisibilityChange(): void {\n for (const subscriber of subscribers) {\n if (document.visibilityState === \"visible\") {\n subscriber.onVisible?.();\n continue;\n }\n\n subscriber.onHidden?.();\n }\n}\n\nfunction handleOnline(): void {\n for (const subscriber of subscribers) {\n subscriber.onOnline?.();\n }\n}\n\nfunction handlePageHide(event: PageTransitionEvent): void {\n for (const subscriber of subscribers) {\n subscriber.onPageHide?.(event);\n }\n}\n\nfunction handlePageShow(event: PageTransitionEvent): void {\n for (const subscriber of subscribers) {\n subscriber.onPageShow?.(event);\n }\n}\n\nfunction installListeners(): void {\n if (\n installed ||\n typeof window === \"undefined\" ||\n typeof document === \"undefined\"\n ) {\n return;\n }\n\n installed = true;\n document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n window.addEventListener(\"online\", handleOnline);\n window.addEventListener(\"pagehide\", handlePageHide);\n window.addEventListener(\"pageshow\", handlePageShow);\n}\n\nfunction uninstallListeners(): void {\n if (\n !installed ||\n typeof window === \"undefined\" ||\n typeof document === \"undefined\"\n ) {\n return;\n }\n\n installed = false;\n document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n window.removeEventListener(\"online\", handleOnline);\n window.removeEventListener(\"pagehide\", handlePageHide);\n window.removeEventListener(\"pageshow\", handlePageShow);\n}\n\nexport function subscribeBrowserLifecycle(\n callbacks: BrowserLifecycleCallbacks,\n): () => void {\n if (typeof window === \"undefined\" || typeof document === \"undefined\") {\n return () => undefined;\n }\n\n subscribers.add(callbacks);\n installListeners();\n\n return () => {\n subscribers.delete(callbacks);\n if (subscribers.size === 0) {\n uninstallListeners();\n }\n };\n}\n","/**\n * Shared lip sync audio analysis: the single RMS computation used across the repo.\n */\nexport const LIPSYNC_FFT_SIZE = 256;\nexport const LIPSYNC_SMOOTHING_TIME_CONSTANT = 0.8;\n\n/**\n * Compute a mouth-open value from frequency data, focusing on speech frequencies.\n */\nexport function computeLipSyncRms(frequencyData: Uint8Array): number {\n // 10-60% of the spectrum (~2-14kHz at a 48kHz context)\n const speechBandStart = Math.floor(frequencyData.length * 0.1);\n const speechBandEnd = Math.floor(frequencyData.length * 0.6);\n\n let sum = 0;\n for (let index = speechBandStart; index < speechBandEnd; index += 1) {\n const normalized = frequencyData[index] / 255;\n sum += normalized * normalized;\n }\n\n const rms = Math.sqrt(sum / (speechBandEnd - speechBandStart));\n return Math.min(rms * 1.7, 1); // Amplify and clamp\n}\n\nexport interface LipSyncAnalyzerOptions {\n onRms: (rms: number) => void;\n onError?: (error: unknown) => void;\n}\n\nexport interface LipSyncAnalyzer {\n /**\n * Create the AudioContext up front (idempotent).\n */\n prepare(): Promise<void>;\n /**\n * Analyze an audio element while keeping its playback audible.\n */\n attachMediaElement(element: HTMLAudioElement): void;\n /**\n * Analyze a media stream without routing it to the speakers.\n */\n attachMediaStream(stream: MediaStream): void;\n /**\n * Temporarily halt analysis; `resume()` restarts it.\n */\n pause(): void;\n resume(): void;\n /**\n * Halt analysis for the current source. `resume()` no-ops until the next attach.\n */\n stop(): void;\n cleanup(): Promise<void>;\n}\n\nclass LipSyncAnalyzerImpl implements LipSyncAnalyzer {\n private audioContext?: AudioContext;\n private analyser?: AnalyserNode;\n private source?: AudioNode;\n private attachedStream?: MediaStream;\n private dataArray?: Uint8Array<ArrayBuffer>;\n private isActive = false;\n private animationFrameId?: number;\n\n constructor(private options: LipSyncAnalyzerOptions) {}\n\n async prepare(): Promise<void> {\n if (this.audioContext) {\n return;\n }\n\n const audioContextConstructor =\n typeof window === \"undefined\"\n ? undefined\n : window.AudioContext ||\n (window as Window & { webkitAudioContext?: typeof AudioContext })\n .webkitAudioContext;\n if (!audioContextConstructor) {\n throw new Error(\"AudioContext is not supported in this browser\");\n }\n\n this.audioContext = new audioContextConstructor();\n }\n\n attachMediaElement(element: HTMLAudioElement): void {\n this.stop();\n this.resetNodes();\n\n try {\n const audioContext = this.ensureAudioContext();\n if (!audioContext) {\n return;\n }\n\n const analyser = this.createAnalyser(audioContext);\n const source = audioContext.createMediaElementSource(element);\n source.connect(analyser);\n analyser.connect(audioContext.destination); // Keep playback audible\n\n this.startAnalysis(source, analyser);\n\n // Resume audio context if suspended (required on some browsers)\n if (audioContext.state === \"suspended\") {\n element.addEventListener(\n \"play\",\n () => {\n this.audioContext?.resume();\n },\n { once: true },\n );\n }\n } catch (error) {\n this.options.onError?.(error);\n }\n }\n\n attachMediaStream(stream: MediaStream): void {\n if (this.attachedStream === stream) {\n return;\n }\n\n this.stop();\n this.resetNodes();\n\n try {\n const audioContext = this.ensureAudioContext();\n if (!audioContext) {\n return;\n }\n\n const analyser = this.createAnalyser(audioContext);\n const source = audioContext.createMediaStreamSource(stream);\n source.connect(analyser); // Not connected to the destination: the stream is already audible\n\n this.startAnalysis(source, analyser);\n\n // Memoize only after success so a failed attach stays retryable\n this.attachedStream = stream;\n } catch (error) {\n this.options.onError?.(error);\n }\n }\n\n pause(): void {\n this.cancelLoop();\n this.options.onRms(0);\n }\n\n resume(): void {\n if (\n !this.isActive ||\n this.animationFrameId !== undefined ||\n !this.analyser ||\n !this.dataArray\n ) {\n return;\n }\n\n this.analyzeFrame();\n }\n\n stop(): void {\n this.isActive = false;\n this.attachedStream = undefined;\n this.cancelLoop();\n this.options.onRms(0); // Reset mouth to closed position\n }\n\n async cleanup(): Promise<void> {\n // Clear every reference synchronously so a prepare() racing an in-flight\n // close() creates a fresh context instead of reusing the closing one.\n this.stop();\n this.resetNodes();\n this.dataArray = undefined;\n\n const audioContext = this.audioContext;\n this.audioContext = undefined;\n\n await audioContext?.close();\n }\n\n /**\n * Create the context lazily so callers can attach without awaiting prepare().\n *\n * This relies on prepare() staying await-free before it assigns\n * `this.audioContext`: the void call below runs its body synchronously, so\n * the context is already visible when this returns on the same tick.\n */\n private ensureAudioContext(): AudioContext | undefined {\n if (!this.audioContext) {\n void this.prepare().catch((error) => {\n this.options.onError?.(error);\n });\n }\n\n return this.audioContext;\n }\n\n private createAnalyser(audioContext: AudioContext): AnalyserNode {\n const analyser = audioContext.createAnalyser();\n analyser.fftSize = LIPSYNC_FFT_SIZE;\n analyser.smoothingTimeConstant = LIPSYNC_SMOOTHING_TIME_CONSTANT;\n return analyser;\n }\n\n private startAnalysis(source: AudioNode, analyser: AnalyserNode): void {\n this.source = source;\n this.analyser = analyser;\n this.dataArray = new Uint8Array(analyser.frequencyBinCount);\n this.isActive = true;\n this.analyzeFrame();\n }\n\n private analyzeFrame(): void {\n if (!this.isActive || !this.analyser || !this.dataArray) {\n return;\n }\n\n this.analyser.getByteFrequencyData(this.dataArray);\n this.options.onRms(computeLipSyncRms(this.dataArray));\n\n this.animationFrameId = requestAnimationFrame(() => this.analyzeFrame());\n }\n\n private cancelLoop(): void {\n if (this.animationFrameId !== undefined) {\n cancelAnimationFrame(this.animationFrameId);\n this.animationFrameId = undefined;\n }\n }\n\n private resetNodes(): void {\n if (this.source) {\n this.source.disconnect();\n this.source = undefined;\n }\n\n if (this.analyser) {\n this.analyser.disconnect();\n this.analyser = undefined;\n }\n }\n}\n\nexport function createLipSyncAnalyzer(\n options: LipSyncAnalyzerOptions,\n): LipSyncAnalyzer {\n return new LipSyncAnalyzerImpl(options);\n}\n","/**\n * Shared tool validation: the single argument/result contract enforced before\n * and after a tool handler runs, regardless of the modality that calls it.\n *\n * Errors here are plain `Error`, not a `CharivoErrorKind` variant, on purpose:\n * this preserves message-string compatibility with the pre-move realtime\n * validator, and no existing error kind fits schema validation.\n */\nimport type { ToolDefinition } from \"./types\";\n\n/**\n * Validates tool call arguments against a definition's parameter schema.\n *\n * Enforces only: required-key presence, `enum` membership, and each\n * property's top-level `type`. Nested schemas, `additionalProperties`, and\n * numeric-length constraints (`minLength`, `maximum`, etc.) are not\n * validated. Throws a plain `Error` on the first violation found.\n *\n * @param toolLabel - Prefixes thrown messages (e.g. `${toolLabel} \"name\" ...`);\n * callers use this to distinguish realtime tools from other modalities.\n */\nexport function validateToolArguments(\n definition: ToolDefinition,\n args: unknown,\n toolLabel = \"Tool\",\n): void {\n if (!isRecord(args) || Array.isArray(args)) {\n throw new Error(\n `${toolLabel} \"${definition.name}\" arguments failed schema validation: arguments must be an object`,\n );\n }\n\n const { parameters } = definition;\n const required = parameters.required ?? [];\n\n for (const propertyName of required) {\n if (!hasOwnProperty(args, propertyName)) {\n throw new Error(\n `${toolLabel} \"${definition.name}\" arguments failed schema validation: missing required property \"${propertyName}\"`,\n );\n }\n }\n\n for (const [propertyName, schema] of Object.entries(parameters.properties)) {\n if (!hasOwnProperty(args, propertyName) || !isRecord(schema)) {\n continue;\n }\n\n validateToolArgumentValue(\n definition.name,\n propertyName,\n args[propertyName],\n schema,\n toolLabel,\n );\n }\n}\n\n/**\n * Tool handlers must resolve to a plain object; arrays and primitives are not\n * serializable tool outputs. Throws a plain `Error` on violation.\n *\n * @param toolLabel - Prefixes the thrown message (e.g. `${toolLabel} \"name\" ...`);\n * callers use this to distinguish realtime tools from other modalities.\n */\nexport function assertToolResultObject(\n result: unknown,\n toolName: string,\n toolLabel = \"Tool\",\n): asserts result is Record<string, unknown> {\n if (!isRecord(result) || Array.isArray(result)) {\n throw new Error(`${toolLabel} \"${toolName}\" must return an object`);\n }\n}\n\nfunction validateToolArgumentValue(\n toolName: string,\n propertyName: string,\n value: unknown,\n schema: Record<string, unknown>,\n toolLabel: string,\n): void {\n const enumValues = schema.enum;\n if (\n Array.isArray(enumValues) &&\n !enumValues.some((item) => Object.is(item, value))\n ) {\n throw new Error(\n `${toolLabel} \"${toolName}\" arguments failed schema validation: property \"${propertyName}\" must be one of ${formatEnumValues(enumValues)}`,\n );\n }\n\n const expectedType = schema.type;\n if (typeof expectedType !== \"string\") {\n return;\n }\n\n if (!isSupportedSchemaType(expectedType)) {\n throw new Error(\n `${toolLabel} \"${toolName}\" arguments failed schema validation: property \"${propertyName}\" uses unsupported schema type \"${expectedType}\"`,\n );\n }\n\n if (!matchesSchemaType(value, expectedType)) {\n throw new Error(\n `${toolLabel} \"${toolName}\" arguments failed schema validation: property \"${propertyName}\" must be ${expectedType}`,\n );\n }\n}\n\nfunction matchesSchemaType(value: unknown, expectedType: string): boolean {\n switch (expectedType) {\n case \"string\":\n return typeof value === \"string\";\n case \"number\":\n return typeof value === \"number\" && Number.isFinite(value);\n case \"integer\":\n return typeof value === \"number\" && Number.isInteger(value);\n case \"boolean\":\n return typeof value === \"boolean\";\n case \"object\":\n return isRecord(value) && !Array.isArray(value);\n case \"array\":\n return Array.isArray(value);\n case \"null\":\n return value === null;\n }\n\n return false;\n}\n\nfunction isSupportedSchemaType(expectedType: string): boolean {\n return (\n expectedType === \"string\" ||\n expectedType === \"number\" ||\n expectedType === \"integer\" ||\n expectedType === \"boolean\" ||\n expectedType === \"object\" ||\n expectedType === \"array\" ||\n expectedType === \"null\"\n );\n}\n\nfunction formatEnumValues(values: unknown[]): string {\n return values.map((value) => JSON.stringify(value)).join(\", \");\n}\n\nfunction hasOwnProperty(\n record: Record<string, unknown>,\n propertyName: string,\n): boolean {\n return Object.prototype.hasOwnProperty.call(record, propertyName);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null;\n}\n","/**\n * Shared tool-execution plumbing: the registry, timeout, failure-output, and\n * serialization behavior every modality's tool runner needs.\n *\n * Like the validators in `./tool-validation`, each helper takes a `toolLabel`\n * so callers can distinguish realtime tools from other modalities in thrown\n * messages. Errors are plain `Error` for the same reason given there.\n */\nimport type { ToolDefinition, ToolRegistration } from \"./types\";\nimport { assertToolResultObject } from \"./tool-validation\";\n\n/** Registry of the tools a session may execute, keyed by definition name. */\nexport interface ToolRegistry {\n register(tool: ToolRegistration): void;\n unregister(name: string): void;\n get(name: string): ToolRegistration | undefined;\n size(): number;\n /** Deep-copied definitions, safe to hand to a provider without aliasing. */\n getDefinitions(): ToolDefinition[];\n}\n\nexport function createToolRegistry(): ToolRegistry {\n const tools = new Map<string, ToolRegistration>();\n\n return {\n register(tool) {\n tools.set(tool.definition.name, tool);\n },\n\n unregister(name) {\n tools.delete(name);\n },\n\n get(name) {\n return tools.get(name);\n },\n\n size() {\n return tools.size;\n },\n\n getDefinitions() {\n // JSON round-trip rather than a spread: definitions are JSON\n // Schema-shaped and must survive serialization to reach a provider\n // anyway, and a shallow copy would leave nested schemas (an `enum`\n // array, a nested `properties` object) aliased into the registration.\n return Array.from(\n tools.values(),\n (tool) => JSON.parse(JSON.stringify(tool.definition)) as ToolDefinition,\n );\n },\n };\n}\n\n/** Always-serializable output handed back to the model when a tool call fails. */\nexport function createToolFailureOutput(error: Error): Record<string, unknown> {\n return {\n success: false,\n error: error.message,\n };\n}\n\nexport async function withToolTimeout<T>(\n promise: Promise<T>,\n timeoutMs: number,\n toolName: string,\n toolLabel = \"Tool\",\n): Promise<T> {\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n try {\n return await Promise.race([\n promise,\n new Promise<never>((_, reject) => {\n timeoutId = setTimeout(() => {\n reject(\n new Error(\n `${toolLabel} \"${toolName}\" timed out after ${timeoutMs}ms`,\n ),\n );\n }, timeoutMs);\n }),\n ]);\n } finally {\n if (timeoutId !== undefined) {\n clearTimeout(timeoutId);\n }\n }\n}\n\n/**\n * Serializes a tool result, throwing when it cannot be represented as JSON.\n *\n * Package-internal: exported for this module's unit tests only, and\n * deliberately NOT re-exported from the package root. `snapshotToolResult` is\n * the supported entry point — it is the only caller, and callers need the\n * parsed snapshot alongside the string.\n *\n * `JSON.stringify` is declared to return `string`, but it returns the value\n * `undefined` at runtime for inputs whose `toJSON()` yields `undefined` — a\n * case that throws nothing and would otherwise drop the payload silently, so\n * it is checked explicitly rather than relying on a thrown error.\n */\nexport function serializeToolResult(\n result: Record<string, unknown>,\n toolName: string,\n toolLabel = \"Tool\",\n): string {\n const serialized: unknown = JSON.stringify(result);\n\n if (typeof serialized !== \"string\") {\n throw new Error(\n `${toolLabel} \"${toolName}\" result could not be serialized to JSON`,\n );\n }\n\n return serialized;\n}\n\n/** A tool result's JSON string plus the parsed value every consumer sees. */\nexport interface ToolResultSnapshot {\n /** Handed to the model's tool turn, or to the realtime transport. */\n serialized: string;\n /** Parsed form of `serialized` — what `tool:result` and projectors receive. */\n snapshot: Record<string, unknown>;\n}\n\n/**\n * Serializes a tool result once and returns both the string and its parsed\n * snapshot, so every consumer downstream of a tool runner sees the same JSON\n * shape regardless of modality.\n *\n * Call this inside a tool runner's failure boundary: a result that cannot be\n * represented as JSON throws here and degrades to a failure output instead of\n * reaching a transport or a projector. Serializing proves the result is\n * representable, but a `toJSON()` can still yield null, an array, or a\n * primitive, so the parsed value is checked against the tool-result contract\n * rather than cast to it.\n */\nexport function snapshotToolResult(\n result: Record<string, unknown>,\n toolName: string,\n toolLabel = \"Tool\",\n): ToolResultSnapshot {\n const serialized = serializeToolResult(result, toolName, toolLabel);\n const parsed: unknown = JSON.parse(serialized);\n\n assertToolResultObject(parsed, toolName, toolLabel);\n\n return { serialized, snapshot: parsed };\n}\n","import { EventBus } from \"./bus\";\nimport {\n Character,\n Message,\n RenderManager,\n TTSManager,\n STTManager,\n LLMManager,\n} from \"./types\";\nimport { toCharivoError, type CharivoError } from \"./errors\";\n\nexport * from \"./types\";\nexport { EventBus } from \"./bus\";\nexport {\n type BrowserLifecycleCallbacks,\n subscribeBrowserLifecycle,\n} from \"./browser-lifecycle\";\nexport {\n type CharivoErrorCode,\n type CharivoErrorOptions,\n CharivoError,\n CharivoStateError,\n CharivoTimeoutError,\n CharivoTransportError,\n CharivoProviderError,\n CharivoDisposeError,\n type CharivoErrorKind,\n isCharivoError,\n getErrorMessage,\n toCharivoError,\n} from \"./errors\";\nexport {\n createLipSyncAnalyzer,\n type LipSyncAnalyzer,\n type LipSyncAnalyzerOptions,\n} from \"./lipsync-analyzer\";\nexport {\n assertToolResultObject,\n validateToolArguments,\n} from \"./tool-validation\";\nexport {\n createToolFailureOutput,\n createToolRegistry,\n snapshotToolResult,\n type ToolRegistry,\n type ToolResultSnapshot,\n withToolTimeout,\n} from \"./tool-execution\";\n\nexport class Charivo {\n private eventBus: EventBus;\n private llmManager?: LLMManager;\n private renderManager?: RenderManager;\n private ttsManager?: TTSManager;\n private sttManager?: STTManager;\n private realtimeManager?: import(\"./types\").RealtimeManager;\n private character?: Character;\n private isRealtimeMode = false;\n\n constructor() {\n this.eventBus = new EventBus();\n }\n\n /**\n * Attach a render manager to handle character visualization.\n * Automatically connects the event bus and sets the current character if available.\n */\n attachRenderer(renderManager: RenderManager): void {\n // Disconnect the currently-attached manager before replacing it (fixes replace leak)\n if (this.renderManager && this.renderManager !== renderManager) {\n this.renderManager.disconnect();\n }\n\n this.renderManager = renderManager;\n this.connectRenderManagerEventBus(renderManager);\n\n // Set character if it was already configured\n if (this.character) {\n renderManager.setCharacter(this.character);\n }\n }\n\n /**\n * Connects the render manager to the event bus for bidirectional communication.\n */\n private connectRenderManagerEventBus(renderManager: RenderManager): void {\n renderManager.setEventBus(this.eventBus);\n }\n\n /**\n * Attach an LLM manager to handle conversation generation.\n * Automatically sets the current character if available.\n */\n attachLLM(manager: LLMManager): void {\n this.llmManager = manager;\n this.connectLLMManagerEventEmitter(manager);\n\n // Set character if it was already configured\n if (this.character) {\n manager.setCharacter(this.character);\n }\n }\n\n /**\n * Attach a TTS manager to handle voice synthesis.\n * Automatically connects the event emitter for audio events.\n */\n attachTTS(manager: TTSManager): void {\n this.ttsManager = manager;\n this.connectTTSManagerEventEmitter(manager);\n }\n\n /**\n * Detach the TTS manager to disable voice synthesis.\n */\n detachTTS(): void {\n this.ttsManager = undefined;\n }\n\n /**\n * Attach an STT manager to handle speech recognition.\n * Automatically connects the event emitter for STT events.\n */\n attachSTT(manager: STTManager): void {\n this.sttManager = manager;\n this.connectSTTManagerEventEmitter(manager);\n }\n\n /**\n * Detach the STT manager to disable speech recognition.\n */\n detachSTT(): void {\n this.sttManager = undefined;\n }\n\n /**\n * Detach the LLM manager to disable chat completions.\n */\n detachLLM(): void {\n this.llmManager = undefined;\n }\n\n /**\n * Detach the render manager without destroying it.\n */\n detachRenderer(): void {\n this.renderManager?.disconnect();\n this.renderManager = undefined;\n }\n\n /**\n * Connects the TTS manager to the event bus for audio event emission.\n */\n private connectTTSManagerEventEmitter(manager: TTSManager): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Connects the STT manager to the event bus for speech recognition event emission.\n */\n private connectSTTManagerEventEmitter(manager: STTManager): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Connects the LLM manager to the event bus for tool-call event emission.\n */\n private connectLLMManagerEventEmitter(manager: LLMManager): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Set the character for this Charivo instance.\n * Automatically propagates to all attached managers (LLM, Renderer).\n */\n setCharacter(character: Character): void {\n this.character = character;\n\n if (this.llmManager) {\n this.llmManager.setCharacter(character);\n }\n\n if (this.renderManager) {\n this.renderManager.setCharacter(character);\n }\n\n if (this.realtimeManager) {\n this.realtimeManager.setCharacter(character);\n }\n }\n\n /**\n * Process a user message and generate a character response.\n * Orchestrates the full conversation flow: rendering, LLM generation, and TTS playback.\n */\n async userSay(content: string): Promise<void> {\n const userMessage: Message = {\n id: Date.now().toString(),\n content,\n timestamp: new Date(),\n type: \"user\",\n };\n\n this.eventBus.emit(\"message:sent\", { message: userMessage });\n\n // Render user message\n if (this.renderManager) {\n try {\n await this.renderManager.render(userMessage);\n } catch (error) {\n throw toCharivoError(\"state\", error, \"Failed to render user message\");\n }\n }\n\n // Generate and render character response\n if (this.llmManager && this.character) {\n const response = await this.llmManager\n .generateResponse(userMessage)\n .catch((error) =>\n Promise.reject(\n toCharivoError(\n \"provider\",\n error,\n \"Failed to generate a character response\",\n ),\n ),\n );\n\n const characterMessage: Message = {\n id: Date.now().toString() + \"_response\",\n content: response,\n timestamp: new Date(),\n characterId: this.character.id,\n type: \"character\",\n };\n\n this.eventBus.emit(\"message:received\", { message: characterMessage });\n this.eventBus.emit(\"character:speak\", {\n character: this.character,\n message: response,\n });\n\n if (this.renderManager) {\n try {\n await this.renderManager.render(characterMessage, this.character);\n } catch (error) {\n throw toCharivoError(\n \"state\",\n error,\n \"Failed to render character response\",\n );\n }\n }\n\n if (this.ttsManager) {\n try {\n this.eventBus.emit(\"tts:start\", {\n text: response,\n characterId: this.character.id,\n });\n\n const ttsOptions = this.character.voice\n ? {\n rate: this.character.voice.rate,\n pitch: this.character.voice.pitch,\n volume: this.character.voice.volume,\n voice: this.character.voice.voiceId,\n }\n : undefined;\n\n await this.ttsManager.speak(response, ttsOptions);\n this.eventBus.emit(\"tts:end\", { characterId: this.character.id });\n } catch (error) {\n const typedError = toCharivoError(\"provider\", error);\n this.eventBus.emit(\"tts:error\", { error: typedError });\n }\n }\n }\n }\n\n /**\n * Clear the conversation history from the LLM manager.\n */\n clearHistory(): void {\n if (this.llmManager) {\n this.llmManager.clearHistory();\n }\n }\n\n /**\n * Get the conversation history from the LLM manager.\n */\n getHistory(): Message[] {\n return this.llmManager ? this.llmManager.getHistory() : [];\n }\n\n /**\n * Get the currently configured character.\n */\n getCurrentCharacter(): Character | null {\n return this.character ?? null;\n }\n\n /**\n * Get the current STT manager instance.\n */\n getSTTManager(): STTManager | undefined {\n return this.sttManager;\n }\n\n /**\n * Get the current render manager instance.\n */\n getRenderManager(): RenderManager | undefined {\n return this.renderManager;\n }\n\n /**\n * Attach a Realtime manager to handle real-time conversation.\n * Automatically connects the event emitter and enables Realtime mode.\n */\n attachRealtime(manager: import(\"./types\").RealtimeManager): void {\n this.realtimeManager = manager;\n this.isRealtimeMode = true;\n this.connectRealtimeManagerEventEmitter(manager);\n\n if (this.character) {\n manager.setCharacter(this.character);\n }\n }\n\n /**\n * Detach the Realtime manager and disable Realtime mode.\n */\n detachRealtime(): void {\n this.realtimeManager = undefined;\n this.isRealtimeMode = false;\n }\n\n /**\n * Check if Realtime mode is enabled.\n */\n isRealtimeModeEnabled(): boolean {\n return this.isRealtimeMode;\n }\n\n /**\n * Connects the Realtime manager to the event bus.\n */\n private connectRealtimeManagerEventEmitter(\n manager: import(\"./types\").RealtimeManager,\n ): void {\n if (manager.setEventEmitter) {\n manager.setEventEmitter(this.eventBus);\n }\n }\n\n /**\n * Get the current Realtime manager instance.\n */\n getRealtimeManager(): import(\"./types\").RealtimeManager | undefined {\n return this.realtimeManager;\n }\n\n /**\n * Subscribe to events from the event bus.\n */\n on<K extends keyof import(\"./types\").EventMap>(\n event: K,\n listener: (data: import(\"./types\").EventMap[K]) => void,\n ): void {\n this.eventBus.on(event, listener);\n }\n\n /**\n * Unsubscribe from events from the event bus.\n */\n off<K extends keyof import(\"./types\").EventMap>(\n event: K,\n listener: (data: import(\"./types\").EventMap[K]) => void,\n ): void {\n this.eventBus.off(event, listener);\n }\n\n /**\n * Emit events to the event bus.\n */\n emit<K extends keyof import(\"./types\").EventMap>(\n event: K,\n data: import(\"./types\").EventMap[K],\n ): void {\n this.eventBus.emit(event, data);\n }\n\n async dispose(): Promise<void> {\n let firstError: CharivoError | null = null;\n\n const recordError = (error: unknown, fallbackMessage: string): void => {\n const typedError = toCharivoError(\"dispose\", error, fallbackMessage);\n if (!firstError) {\n firstError = typedError;\n }\n };\n\n if (this.realtimeManager) {\n try {\n await this.realtimeManager.stopSession();\n } catch (error) {\n recordError(error, \"Failed to stop realtime session during dispose\");\n }\n }\n\n if (this.ttsManager) {\n try {\n await this.ttsManager.stop();\n } catch (error) {\n recordError(error, \"Failed to stop TTS during dispose\");\n }\n\n // Runs even when stop() failed: audio resources must still be released.\n try {\n await this.ttsManager.dispose?.();\n } catch (error) {\n recordError(error, \"Failed to release TTS resources during dispose\");\n }\n }\n\n if (this.sttManager) {\n try {\n if (this.sttManager.isRecording()) {\n await this.sttManager.stop();\n }\n } catch (error) {\n recordError(error, \"Failed to stop STT during dispose\");\n }\n }\n\n if (this.renderManager) {\n try {\n await this.renderManager.destroy();\n } catch (error) {\n recordError(error, \"Failed to destroy renderer during dispose\");\n }\n }\n\n if (this.llmManager) {\n try {\n this.llmManager.clearHistory();\n } catch (error) {\n recordError(error, \"Failed to clear LLM history during dispose\");\n }\n }\n\n this.detachRealtime();\n this.detachTTS();\n this.detachSTT();\n this.detachLLM();\n // renderManager was already destroyed+disconnected in the guarded block above;\n // bypass detachRenderer() here to avoid a second disconnect() call.\n this.renderManager = undefined;\n this.character = undefined;\n this.isRealtimeMode = false;\n this.eventBus.clear();\n\n return this.finishDispose(firstError);\n }\n\n private finishDispose(firstError: CharivoError | null): void {\n if (firstError) {\n throw firstError;\n }\n }\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@charivo/core",
3
- "version": "0.18.0",
3
+ "version": "0.20.0",
4
4
  "description": "Core functionality for Charivo character system",
5
5
  "type": "module",
6
6
  "main": "dist/index.cjs",