@charivo/core 0.8.0 → 0.10.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 +17 -0
- package/dist/index.cjs +194 -4
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +45 -1
- package/dist/index.d.ts +45 -1
- package/dist/index.js +186 -5
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -42,8 +42,11 @@ The `Charivo` instance wires managers together:
|
|
|
42
42
|
- `attachTTS(ttsManager)`
|
|
43
43
|
- `attachSTT(sttManager)`
|
|
44
44
|
- `attachRealtime(realtimeManager)`
|
|
45
|
+
- `detachLLM()`
|
|
46
|
+
- `detachRenderer()`
|
|
45
47
|
- `setCharacter(character)`
|
|
46
48
|
- `userSay(text)`
|
|
49
|
+
- `dispose()`
|
|
47
50
|
- `clearHistory()`
|
|
48
51
|
- `getHistory()`
|
|
49
52
|
- `on(event, listener)`
|
|
@@ -53,6 +56,19 @@ The current render-manager contract is explicit: a `RenderManager` must expose
|
|
|
53
56
|
`setEventBus(eventBus)` so the core can connect typed character, TTS, and
|
|
54
57
|
realtime events without duck typing.
|
|
55
58
|
|
|
59
|
+
## Errors
|
|
60
|
+
|
|
61
|
+
Public methods throw typed errors exported from `@charivo/core`:
|
|
62
|
+
|
|
63
|
+
- `CharivoStateError`
|
|
64
|
+
- `CharivoTimeoutError`
|
|
65
|
+
- `CharivoTransportError`
|
|
66
|
+
- `CharivoProviderError`
|
|
67
|
+
- `CharivoDisposeError`
|
|
68
|
+
|
|
69
|
+
Prefer `instanceof CharivoError` or `error.code` checks over
|
|
70
|
+
`error.message.includes(...)`.
|
|
71
|
+
|
|
56
72
|
## Events
|
|
57
73
|
|
|
58
74
|
Important event names include:
|
|
@@ -79,6 +95,7 @@ Important event names include:
|
|
|
79
95
|
- `realtime:tool:call`
|
|
80
96
|
- `realtime:tool:result`
|
|
81
97
|
- `realtime:tool:error`
|
|
98
|
+
- `realtime:usage`
|
|
82
99
|
- `realtime:expression`
|
|
83
100
|
- `realtime:motion`
|
|
84
101
|
- `realtime:gaze`
|
package/dist/index.cjs
CHANGED
|
@@ -28,6 +28,94 @@ var EventBus = class {
|
|
|
28
28
|
}
|
|
29
29
|
};
|
|
30
30
|
|
|
31
|
+
// src/errors.ts
|
|
32
|
+
var CharivoError = class extends Error {
|
|
33
|
+
code;
|
|
34
|
+
constructor(message, options = {}) {
|
|
35
|
+
super(message, options);
|
|
36
|
+
this.name = "CharivoError";
|
|
37
|
+
this.code = options.code ?? "CHARIVO_ERROR";
|
|
38
|
+
}
|
|
39
|
+
};
|
|
40
|
+
var CharivoStateError = class extends CharivoError {
|
|
41
|
+
constructor(message, options = {}) {
|
|
42
|
+
super(message, {
|
|
43
|
+
...options,
|
|
44
|
+
code: "CHARIVO_STATE_ERROR"
|
|
45
|
+
});
|
|
46
|
+
this.name = "CharivoStateError";
|
|
47
|
+
}
|
|
48
|
+
};
|
|
49
|
+
var CharivoTimeoutError = class extends CharivoError {
|
|
50
|
+
constructor(message, options = {}) {
|
|
51
|
+
super(message, {
|
|
52
|
+
...options,
|
|
53
|
+
code: "CHARIVO_TIMEOUT_ERROR"
|
|
54
|
+
});
|
|
55
|
+
this.name = "CharivoTimeoutError";
|
|
56
|
+
}
|
|
57
|
+
};
|
|
58
|
+
var CharivoTransportError = class extends CharivoError {
|
|
59
|
+
constructor(message, options = {}) {
|
|
60
|
+
super(message, {
|
|
61
|
+
...options,
|
|
62
|
+
code: "CHARIVO_TRANSPORT_ERROR"
|
|
63
|
+
});
|
|
64
|
+
this.name = "CharivoTransportError";
|
|
65
|
+
}
|
|
66
|
+
};
|
|
67
|
+
var CharivoProviderError = class extends CharivoError {
|
|
68
|
+
constructor(message, options = {}) {
|
|
69
|
+
super(message, {
|
|
70
|
+
...options,
|
|
71
|
+
code: "CHARIVO_PROVIDER_ERROR"
|
|
72
|
+
});
|
|
73
|
+
this.name = "CharivoProviderError";
|
|
74
|
+
}
|
|
75
|
+
};
|
|
76
|
+
var CharivoDisposeError = class extends CharivoError {
|
|
77
|
+
constructor(message, options = {}) {
|
|
78
|
+
super(message, {
|
|
79
|
+
...options,
|
|
80
|
+
code: "CHARIVO_DISPOSE_ERROR"
|
|
81
|
+
});
|
|
82
|
+
this.name = "CharivoDisposeError";
|
|
83
|
+
}
|
|
84
|
+
};
|
|
85
|
+
function isCharivoError(error) {
|
|
86
|
+
return error instanceof CharivoError;
|
|
87
|
+
}
|
|
88
|
+
function getErrorMessage(error, fallback = "Unknown error") {
|
|
89
|
+
if (typeof error === "string" && error.trim().length > 0) {
|
|
90
|
+
return error;
|
|
91
|
+
}
|
|
92
|
+
if (error instanceof Error && error.message.trim().length > 0) {
|
|
93
|
+
return error.message;
|
|
94
|
+
}
|
|
95
|
+
return fallback;
|
|
96
|
+
}
|
|
97
|
+
function toCharivoError(kind, error, fallbackMessage) {
|
|
98
|
+
if (isCharivoError(error)) {
|
|
99
|
+
return error;
|
|
100
|
+
}
|
|
101
|
+
const message = getErrorMessage(error, fallbackMessage);
|
|
102
|
+
const options = error instanceof Error ? {
|
|
103
|
+
cause: error
|
|
104
|
+
} : void 0;
|
|
105
|
+
switch (kind) {
|
|
106
|
+
case "state":
|
|
107
|
+
return new CharivoStateError(message, options);
|
|
108
|
+
case "timeout":
|
|
109
|
+
return new CharivoTimeoutError(message, options);
|
|
110
|
+
case "transport":
|
|
111
|
+
return new CharivoTransportError(message, options);
|
|
112
|
+
case "provider":
|
|
113
|
+
return new CharivoProviderError(message, options);
|
|
114
|
+
case "dispose":
|
|
115
|
+
return new CharivoDisposeError(message, options);
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
|
|
31
119
|
// src/types.ts
|
|
32
120
|
var OPENAI_REALTIME_ADAPTER = "openai-webrtc";
|
|
33
121
|
var OPENAI_REALTIME_AGENTS_ADAPTER = "openai-agents-webrtc";
|
|
@@ -161,6 +249,18 @@ var Charivo = class {
|
|
|
161
249
|
detachSTT() {
|
|
162
250
|
this.sttManager = void 0;
|
|
163
251
|
}
|
|
252
|
+
/**
|
|
253
|
+
* Detach the LLM manager to disable chat completions.
|
|
254
|
+
*/
|
|
255
|
+
detachLLM() {
|
|
256
|
+
this.llmManager = void 0;
|
|
257
|
+
}
|
|
258
|
+
/**
|
|
259
|
+
* Detach the render manager without destroying it.
|
|
260
|
+
*/
|
|
261
|
+
detachRenderer() {
|
|
262
|
+
this.renderManager = void 0;
|
|
263
|
+
}
|
|
164
264
|
/**
|
|
165
265
|
* Connects the TTS manager to the event bus for audio event emission.
|
|
166
266
|
*/
|
|
@@ -206,10 +306,22 @@ var Charivo = class {
|
|
|
206
306
|
};
|
|
207
307
|
this.eventBus.emit("message:sent", { message: userMessage });
|
|
208
308
|
if (this.renderManager) {
|
|
209
|
-
|
|
309
|
+
try {
|
|
310
|
+
await this.renderManager.render(userMessage);
|
|
311
|
+
} catch (error) {
|
|
312
|
+
throw toCharivoError("state", error, "Failed to render user message");
|
|
313
|
+
}
|
|
210
314
|
}
|
|
211
315
|
if (this.llmManager && this.character) {
|
|
212
|
-
const response = await this.llmManager.generateResponse(userMessage)
|
|
316
|
+
const response = await this.llmManager.generateResponse(userMessage).catch(
|
|
317
|
+
(error) => Promise.reject(
|
|
318
|
+
toCharivoError(
|
|
319
|
+
"provider",
|
|
320
|
+
error,
|
|
321
|
+
"Failed to generate a character response"
|
|
322
|
+
)
|
|
323
|
+
)
|
|
324
|
+
);
|
|
213
325
|
const characterMessage = {
|
|
214
326
|
id: Date.now().toString() + "_response",
|
|
215
327
|
content: response,
|
|
@@ -223,7 +335,15 @@ var Charivo = class {
|
|
|
223
335
|
message: response
|
|
224
336
|
});
|
|
225
337
|
if (this.renderManager) {
|
|
226
|
-
|
|
338
|
+
try {
|
|
339
|
+
await this.renderManager.render(characterMessage, this.character);
|
|
340
|
+
} catch (error) {
|
|
341
|
+
throw toCharivoError(
|
|
342
|
+
"state",
|
|
343
|
+
error,
|
|
344
|
+
"Failed to render character response"
|
|
345
|
+
);
|
|
346
|
+
}
|
|
227
347
|
}
|
|
228
348
|
if (this.ttsManager) {
|
|
229
349
|
try {
|
|
@@ -240,7 +360,8 @@ var Charivo = class {
|
|
|
240
360
|
await this.ttsManager.speak(response, ttsOptions);
|
|
241
361
|
this.eventBus.emit("tts:end", { characterId: this.character.id });
|
|
242
362
|
} catch (error) {
|
|
243
|
-
|
|
363
|
+
const typedError = toCharivoError("provider", error);
|
|
364
|
+
this.eventBus.emit("tts:error", { error: typedError });
|
|
244
365
|
}
|
|
245
366
|
}
|
|
246
367
|
}
|
|
@@ -334,12 +455,81 @@ var Charivo = class {
|
|
|
334
455
|
emit(event, data) {
|
|
335
456
|
this.eventBus.emit(event, data);
|
|
336
457
|
}
|
|
458
|
+
async dispose() {
|
|
459
|
+
let firstError = null;
|
|
460
|
+
const recordError = (error, fallbackMessage) => {
|
|
461
|
+
const typedError = toCharivoError("dispose", error, fallbackMessage);
|
|
462
|
+
if (!firstError) {
|
|
463
|
+
firstError = typedError;
|
|
464
|
+
}
|
|
465
|
+
};
|
|
466
|
+
if (this.realtimeManager) {
|
|
467
|
+
try {
|
|
468
|
+
await this.realtimeManager.stopSession();
|
|
469
|
+
} catch (error) {
|
|
470
|
+
recordError(error, "Failed to stop realtime session during dispose");
|
|
471
|
+
}
|
|
472
|
+
}
|
|
473
|
+
if (this.ttsManager) {
|
|
474
|
+
try {
|
|
475
|
+
await this.ttsManager.stop();
|
|
476
|
+
} catch (error) {
|
|
477
|
+
recordError(error, "Failed to stop TTS during dispose");
|
|
478
|
+
}
|
|
479
|
+
}
|
|
480
|
+
if (this.sttManager) {
|
|
481
|
+
try {
|
|
482
|
+
if (this.sttManager.isRecording()) {
|
|
483
|
+
await this.sttManager.stop();
|
|
484
|
+
}
|
|
485
|
+
} catch (error) {
|
|
486
|
+
recordError(error, "Failed to stop STT during dispose");
|
|
487
|
+
}
|
|
488
|
+
}
|
|
489
|
+
if (this.renderManager) {
|
|
490
|
+
try {
|
|
491
|
+
await this.renderManager.destroy();
|
|
492
|
+
} catch (error) {
|
|
493
|
+
recordError(error, "Failed to destroy renderer during dispose");
|
|
494
|
+
}
|
|
495
|
+
}
|
|
496
|
+
if (this.llmManager) {
|
|
497
|
+
try {
|
|
498
|
+
this.llmManager.clearHistory();
|
|
499
|
+
} catch (error) {
|
|
500
|
+
recordError(error, "Failed to clear LLM history during dispose");
|
|
501
|
+
}
|
|
502
|
+
}
|
|
503
|
+
this.detachRealtime();
|
|
504
|
+
this.detachTTS();
|
|
505
|
+
this.detachSTT();
|
|
506
|
+
this.detachLLM();
|
|
507
|
+
this.detachRenderer();
|
|
508
|
+
this.character = void 0;
|
|
509
|
+
this.isRealtimeMode = false;
|
|
510
|
+
this.eventBus.clear();
|
|
511
|
+
return this.finishDispose(firstError);
|
|
512
|
+
}
|
|
513
|
+
finishDispose(firstError) {
|
|
514
|
+
if (firstError) {
|
|
515
|
+
throw firstError;
|
|
516
|
+
}
|
|
517
|
+
}
|
|
337
518
|
};
|
|
338
519
|
|
|
339
520
|
exports.Charivo = Charivo;
|
|
521
|
+
exports.CharivoDisposeError = CharivoDisposeError;
|
|
522
|
+
exports.CharivoError = CharivoError;
|
|
523
|
+
exports.CharivoProviderError = CharivoProviderError;
|
|
524
|
+
exports.CharivoStateError = CharivoStateError;
|
|
525
|
+
exports.CharivoTimeoutError = CharivoTimeoutError;
|
|
526
|
+
exports.CharivoTransportError = CharivoTransportError;
|
|
340
527
|
exports.EventBus = EventBus;
|
|
341
528
|
exports.OPENAI_REALTIME_ADAPTER = OPENAI_REALTIME_ADAPTER;
|
|
342
529
|
exports.OPENAI_REALTIME_AGENTS_ADAPTER = OPENAI_REALTIME_AGENTS_ADAPTER;
|
|
530
|
+
exports.getErrorMessage = getErrorMessage;
|
|
531
|
+
exports.isCharivoError = isCharivoError;
|
|
343
532
|
exports.subscribeBrowserLifecycle = subscribeBrowserLifecycle;
|
|
533
|
+
exports.toCharivoError = toCharivoError;
|
|
344
534
|
//# sourceMappingURL=index.cjs.map
|
|
345
535
|
//# sourceMappingURL=index.cjs.map
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/bus.ts","../src/types.ts","../src/browser-lifecycle.ts","../src/index.ts"],"names":[],"mappings":";;;AAMO,IAAM,WAAN,MAA0C;AAAA,EACvC,YAA2B,EAAC;AAAA,EAEpC,EAAA,CACE,OACA,QAAA,EACM;AACN,IAAA,IAAA,CAAK,SAAA,CAAU,KAAK,CAAA,KAAM,EAAC;AAC3B,IAAA,IAAA,CAAK,SAAA,CAAU,KAAK,CAAA,CAAG,IAAA,CAAK,QAAQ,CAAA;AAAA,EACtC;AAAA,EAEA,IAAA,CAA+B,OAAU,IAAA,EAAyB;AAChE,IAAA,IAAA,CAAK,SAAA,CAAU,KAAK,CAAA,EAAG,OAAA,CAAQ,CAAC,QAAA,KAAa,QAAA,CAAS,IAAI,CAAC,CAAA;AAAA,EAC7D;AAAA,EAEA,GAAA,CACE,OACA,QAAA,EACM;AACN,IAAA,MAAM,cAAA,GAAiB,IAAA,CAAK,SAAA,CAAU,KAAK,CAAA;AAC3C,IAAA,IAAI,CAAC,cAAA,EAAgB;AACnB,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,KAAA,GAAQ,cAAA,CAAe,OAAA,CAAQ,QAAQ,CAAA;AAC7C,IAAA,IAAI,QAAQ,EAAA,EAAI;AACd,MAAA,cAAA,CAAe,MAAA,CAAO,OAAO,CAAC,CAAA;AAAA,IAChC;AAEA,IAAA,IAAI,cAAA,CAAe,WAAW,CAAA,EAAG;AAC/B,MAAA,OAAO,IAAA,CAAK,UAAU,KAAK,CAAA;AAAA,IAC7B;AAAA,EACF;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,YAAY,EAAC;AAAA,EACpB;AACF;;;ACmBO,IAAM,uBAAA,GAA0B;AAChC,IAAM,8BAAA,GAAiC;;;ACvD9C,IAAM,WAAA,uBAAkB,GAAA,EAA+B;AAEvD,IAAI,SAAA,GAAY,KAAA;AAEhB,SAAS,sBAAA,GAA+B;AACtC,EAAA,KAAA,MAAW,cAAc,WAAA,EAAa;AACpC,IAAA,IAAI,QAAA,CAAS,oBAAoB,SAAA,EAAW;AAC1C,MAAA,UAAA,CAAW,SAAA,IAAY;AACvB,MAAA;AAAA,IACF;AAEA,IAAA,UAAA,CAAW,QAAA,IAAW;AAAA,EACxB;AACF;AAEA,SAAS,YAAA,GAAqB;AAC5B,EAAA,KAAA,MAAW,cAAc,WAAA,EAAa;AACpC,IAAA,UAAA,CAAW,QAAA,IAAW;AAAA,EACxB;AACF;AAEA,SAAS,eAAe,KAAA,EAAkC;AACxD,EAAA,KAAA,MAAW,cAAc,WAAA,EAAa;AACpC,IAAA,UAAA,CAAW,aAAa,KAAK,CAAA;AAAA,EAC/B;AACF;AAEA,SAAS,eAAe,KAAA,EAAkC;AACxD,EAAA,KAAA,MAAW,cAAc,WAAA,EAAa;AACpC,IAAA,UAAA,CAAW,aAAa,KAAK,CAAA;AAAA,EAC/B;AACF;AAEA,SAAS,gBAAA,GAAyB;AAChC,EAAA,IACE,aACA,OAAO,MAAA,KAAW,WAAA,IAClB,OAAO,aAAa,WAAA,EACpB;AACA,IAAA;AAAA,EACF;AAEA,EAAA,SAAA,GAAY,IAAA;AACZ,EAAA,QAAA,CAAS,gBAAA,CAAiB,oBAAoB,sBAAsB,CAAA;AACpE,EAAA,MAAA,CAAO,gBAAA,CAAiB,UAAU,YAAY,CAAA;AAC9C,EAAA,MAAA,CAAO,gBAAA,CAAiB,YAAY,cAAc,CAAA;AAClD,EAAA,MAAA,CAAO,gBAAA,CAAiB,YAAY,cAAc,CAAA;AACpD;AAEA,SAAS,kBAAA,GAA2B;AAClC,EAAA,IACE,CAAC,SAAA,IACD,OAAO,WAAW,WAAA,IAClB,OAAO,aAAa,WAAA,EACpB;AACA,IAAA;AAAA,EACF;AAEA,EAAA,SAAA,GAAY,KAAA;AACZ,EAAA,QAAA,CAAS,mBAAA,CAAoB,oBAAoB,sBAAsB,CAAA;AACvE,EAAA,MAAA,CAAO,mBAAA,CAAoB,UAAU,YAAY,CAAA;AACjD,EAAA,MAAA,CAAO,mBAAA,CAAoB,YAAY,cAAc,CAAA;AACrD,EAAA,MAAA,CAAO,mBAAA,CAAoB,YAAY,cAAc,CAAA;AACvD;AAEO,SAAS,0BACd,SAAA,EACY;AACZ,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,OAAO,aAAa,WAAA,EAAa;AACpE,IAAA,OAAO,MAAM,MAAA;AAAA,EACf;AAEA,EAAA,WAAA,CAAY,IAAI,SAAS,CAAA;AACzB,EAAA,gBAAA,EAAiB;AAEjB,EAAA,OAAO,MAAM;AACX,IAAA,WAAA,CAAY,OAAO,SAAS,CAAA;AAC5B,IAAA,IAAI,WAAA,CAAY,SAAS,CAAA,EAAG;AAC1B,MAAA,kBAAA,EAAmB;AAAA,IACrB;AAAA,EACF,CAAA;AACF;;;AC3EO,IAAM,UAAN,MAAc;AAAA,EACX,QAAA;AAAA,EACA,UAAA;AAAA,EACA,aAAA;AAAA,EACA,UAAA;AAAA,EACA,UAAA;AAAA,EACA,eAAA;AAAA,EACA,SAAA;AAAA,EACA,cAAA,GAAiB,KAAA;AAAA,EAEzB,WAAA,GAAc;AACZ,IAAA,IAAA,CAAK,QAAA,GAAW,IAAI,QAAA,EAAS;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,eAAe,aAAA,EAAoC;AACjD,IAAA,IAAA,CAAK,aAAA,GAAgB,aAAA;AACrB,IAAA,IAAA,CAAK,6BAA6B,aAAa,CAAA;AAG/C,IAAA,IAAI,KAAK,SAAA,EAAW;AAClB,MAAA,aAAA,CAAc,YAAA,CAAa,KAAK,SAAS,CAAA;AAAA,IAC3C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,6BAA6B,aAAA,EAAoC;AACvE,IAAA,aAAA,CAAc,WAAA,CAAY,KAAK,QAAQ,CAAA;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAU,OAAA,EAA2B;AACnC,IAAA,IAAA,CAAK,UAAA,GAAa,OAAA;AAGlB,IAAA,IAAI,KAAK,SAAA,EAAW;AAClB,MAAA,OAAA,CAAQ,YAAA,CAAa,KAAK,SAAS,CAAA;AAAA,IACrC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAU,OAAA,EAA2B;AACnC,IAAA,IAAA,CAAK,UAAA,GAAa,OAAA;AAClB,IAAA,IAAA,CAAK,8BAA8B,OAAO,CAAA;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA,EAKA,SAAA,GAAkB;AAChB,IAAA,IAAA,CAAK,UAAA,GAAa,MAAA;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAU,OAAA,EAA2B;AACnC,IAAA,IAAA,CAAK,UAAA,GAAa,OAAA;AAClB,IAAA,IAAA,CAAK,8BAA8B,OAAO,CAAA;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA,EAKA,SAAA,GAAkB;AAChB,IAAA,IAAA,CAAK,UAAA,GAAa,MAAA;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKQ,8BAA8B,OAAA,EAA2B;AAC/D,IAAA,IAAI,QAAQ,eAAA,EAAiB;AAC3B,MAAA,OAAA,CAAQ,eAAA,CAAgB,KAAK,QAAQ,CAAA;AAAA,IACvC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,8BAA8B,OAAA,EAA2B;AAC/D,IAAA,IAAI,QAAQ,eAAA,EAAiB;AAC3B,MAAA,OAAA,CAAQ,eAAA,CAAgB,KAAK,QAAQ,CAAA;AAAA,IACvC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,aAAa,SAAA,EAA4B;AACvC,IAAA,IAAA,CAAK,SAAA,GAAY,SAAA;AAEjB,IAAA,IAAI,KAAK,UAAA,EAAY;AACnB,MAAA,IAAA,CAAK,UAAA,CAAW,aAAa,SAAS,CAAA;AAAA,IACxC;AAEA,IAAA,IAAI,KAAK,aAAA,EAAe;AACtB,MAAA,IAAA,CAAK,aAAA,CAAc,aAAa,SAAS,CAAA;AAAA,IAC3C;AAEA,IAAA,IAAI,KAAK,eAAA,EAAiB;AACxB,MAAA,IAAA,CAAK,eAAA,CAAgB,aAAa,SAAS,CAAA;AAAA,IAC7C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,QAAQ,OAAA,EAAgC;AAC5C,IAAA,MAAM,WAAA,GAAuB;AAAA,MAC3B,EAAA,EAAI,IAAA,CAAK,GAAA,EAAI,CAAE,QAAA,EAAS;AAAA,MACxB,OAAA;AAAA,MACA,SAAA,sBAAe,IAAA,EAAK;AAAA,MACpB,IAAA,EAAM;AAAA,KACR;AAEA,IAAA,IAAA,CAAK,SAAS,IAAA,CAAK,cAAA,EAAgB,EAAE,OAAA,EAAS,aAAa,CAAA;AAG3D,IAAA,IAAI,KAAK,aAAA,EAAe;AACtB,MAAA,MAAM,IAAA,CAAK,aAAA,CAAc,MAAA,CAAO,WAAW,CAAA;AAAA,IAC7C;AAGA,IAAA,IAAI,IAAA,CAAK,UAAA,IAAc,IAAA,CAAK,SAAA,EAAW;AACrC,MAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,UAAA,CAAW,iBAAiB,WAAW,CAAA;AAEnE,MAAA,MAAM,gBAAA,GAA4B;AAAA,QAChC,EAAA,EAAI,IAAA,CAAK,GAAA,EAAI,CAAE,UAAS,GAAI,WAAA;AAAA,QAC5B,OAAA,EAAS,QAAA;AAAA,QACT,SAAA,sBAAe,IAAA,EAAK;AAAA,QACpB,WAAA,EAAa,KAAK,SAAA,CAAU,EAAA;AAAA,QAC5B,IAAA,EAAM;AAAA,OACR;AAEA,MAAA,IAAA,CAAK,SAAS,IAAA,CAAK,kBAAA,EAAoB,EAAE,OAAA,EAAS,kBAAkB,CAAA;AACpE,MAAA,IAAA,CAAK,QAAA,CAAS,KAAK,iBAAA,EAAmB;AAAA,QACpC,WAAW,IAAA,CAAK,SAAA;AAAA,QAChB,OAAA,EAAS;AAAA,OACV,CAAA;AAED,MAAA,IAAI,KAAK,aAAA,EAAe;AACtB,QAAA,MAAM,IAAA,CAAK,aAAA,CAAc,MAAA,CAAO,gBAAA,EAAkB,KAAK,SAAS,CAAA;AAAA,MAClE;AAEA,MAAA,IAAI,KAAK,UAAA,EAAY;AACnB,QAAA,IAAI;AACF,UAAA,IAAA,CAAK,QAAA,CAAS,KAAK,WAAA,EAAa;AAAA,YAC9B,IAAA,EAAM,QAAA;AAAA,YACN,WAAA,EAAa,KAAK,SAAA,CAAU;AAAA,WAC7B,CAAA;AAED,UAAA,MAAM,UAAA,GAAa,IAAA,CAAK,SAAA,CAAU,KAAA,GAC9B;AAAA,YACE,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,KAAA,CAAM,IAAA;AAAA,YAC3B,KAAA,EAAO,IAAA,CAAK,SAAA,CAAU,KAAA,CAAM,KAAA;AAAA,YAC5B,MAAA,EAAQ,IAAA,CAAK,SAAA,CAAU,KAAA,CAAM,MAAA;AAAA,YAC7B,KAAA,EAAO,IAAA,CAAK,SAAA,CAAU,KAAA,CAAM;AAAA,WAC9B,GACA,KAAA,CAAA;AAEJ,UAAA,MAAM,IAAA,CAAK,UAAA,CAAW,KAAA,CAAM,QAAA,EAAU,UAAU,CAAA;AAChD,UAAA,IAAA,CAAK,QAAA,CAAS,KAAK,SAAA,EAAW,EAAE,aAAa,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA;AAAA,QAClE,SAAS,KAAA,EAAO;AACd,UAAA,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,WAAA,EAAa,EAAE,OAAuB,CAAA;AAAA,QAC3D;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,YAAA,GAAqB;AACnB,IAAA,IAAI,KAAK,UAAA,EAAY;AACnB,MAAA,IAAA,CAAK,WAAW,YAAA,EAAa;AAAA,IAC/B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,UAAA,GAAwB;AACtB,IAAA,OAAO,KAAK,UAAA,GAAa,IAAA,CAAK,UAAA,CAAW,UAAA,KAAe,EAAC;AAAA,EAC3D;AAAA;AAAA;AAAA;AAAA,EAKA,mBAAA,GAAwC;AACtC,IAAA,OAAO,KAAK,SAAA,IAAa,IAAA;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA,EAKA,aAAA,GAAwC;AACtC,IAAA,OAAO,IAAA,CAAK,UAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAA,GAA8C;AAC5C,IAAA,OAAO,IAAA,CAAK,aAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,eAAe,OAAA,EAAkD;AAC/D,IAAA,IAAA,CAAK,eAAA,GAAkB,OAAA;AACvB,IAAA,IAAA,CAAK,cAAA,GAAiB,IAAA;AACtB,IAAA,IAAA,CAAK,mCAAmC,OAAO,CAAA;AAE/C,IAAA,IAAI,KAAK,SAAA,EAAW;AAClB,MAAA,OAAA,CAAQ,YAAA,CAAa,KAAK,SAAS,CAAA;AAAA,IACrC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,cAAA,GAAuB;AACrB,IAAA,IAAA,CAAK,eAAA,GAAkB,MAAA;AACvB,IAAA,IAAA,CAAK,cAAA,GAAiB,KAAA;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA,EAKA,qBAAA,GAAiC;AAC/B,IAAA,OAAO,IAAA,CAAK,cAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKQ,mCACN,OAAA,EACM;AACN,IAAA,IAAI,QAAQ,eAAA,EAAiB;AAC3B,MAAA,OAAA,CAAQ,eAAA,CAAgB,KAAK,QAAQ,CAAA;AAAA,IACvC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,kBAAA,GAAoE;AAClE,IAAA,OAAO,IAAA,CAAK,eAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,EAAA,CACE,OACA,QAAA,EACM;AACN,IAAA,IAAA,CAAK,QAAA,CAAS,EAAA,CAAG,KAAA,EAAO,QAAQ,CAAA;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,GAAA,CACE,OACA,QAAA,EACM;AACN,IAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,KAAA,EAAO,QAAQ,CAAA;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA,EAKA,IAAA,CACE,OACA,IAAA,EACM;AACN,IAAA,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,KAAA,EAAO,IAAI,CAAA;AAAA,EAChC;AACF","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 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\nexport interface RealtimeTool {\n type: \"function\";\n name: string;\n description: string;\n parameters: {\n type: \"object\";\n properties: Record<string, unknown>;\n required?: string[];\n };\n}\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?: RealtimeTool[];\n toolChoice?: RealtimeToolChoice;\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 RealtimeToolContext {\n character?: Character | null;\n state: RealtimeState;\n callId?: string;\n}\n\nexport type RealtimeToolHandler = (\n args: Record<string, unknown>,\n context: RealtimeToolContext,\n) => Promise<Record<string, unknown>>;\n\nexport interface RealtimeToolRegistration {\n definition: RealtimeTool;\n handler: RealtimeToolHandler;\n timeoutMs?: number;\n}\n\nexport interface LLMAdapter {\n generateResponse(message: Message): Promise<string>;\n setCharacter(character: Character): void;\n clearHistory(): void;\n}\n\n// LLM 제공자 (서버사이드에서 LLM 응답 생성)\nexport interface LLMProvider {\n generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string>;\n}\n\n// 단순한 LLM 호출 클라이언트 (stateless)\nexport interface LLMClient {\n call(messages: Array<{ role: string; content: string }>): Promise<string>;\n}\n\n// LLM 매니저 (세션 관리, 히스토리, 캐릭터 관리)\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}\n\n// Renderer 인터페이스 (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 매니저 (세션 관리, 립싱크, 모션 제어)\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 setEventBus(eventBus: CharivoEventBus): void;\n prepareAudio?(): Promise<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 플레이어 (브라우저에서 음성 재생)\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 // Stateless audio generation (optional)\n generateAudio?(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n}\n\n// TTS 제공자 (오디오 데이터 생성)\nexport interface TTSProvider {\n generateSpeech(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n setVoice(voice: string): void;\n}\n\n// TTS Manager - TTS 세션의 상태 관리를 담당하는 인터페이스\nexport interface TTSManager {\n speak(text: string, options?: TTSOptions): Promise<void>;\n stop(): Promise<void>;\n setVoice(voice: string): void;\n isSupported(): boolean;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): 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}\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 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: RealtimeToolRegistration): void;\n unregisterTool(name: string): void;\n getRegisteredTools(): RealtimeTool[];\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\": { audioElement?: HTMLAudioElement; characterId?: string };\n \"tts:audio:end\": { characterId?: string };\n \"tts:lipsync:update\": { rms: number; characterId?: string };\n \"stt:start\": { options?: STTOptions };\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:expression\": { expressionId: string };\n \"realtime:motion\": { group: string; index: number };\n \"realtime: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","import { EventBus } from \"./bus\";\nimport {\n Character,\n Message,\n RenderManager,\n TTSManager,\n STTManager,\n LLMManager,\n} from \"./types\";\n\nexport * from \"./types\";\nexport * from \"./bus\";\nexport * from \"./browser-lifecycle\";\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 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\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 * 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 * 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 await this.renderManager.render(userMessage);\n }\n\n // Generate and render character response\n if (this.llmManager && this.character) {\n const response = await this.llmManager.generateResponse(userMessage);\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 await this.renderManager.render(characterMessage, this.character);\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 this.eventBus.emit(\"tts:error\", { error: error as Error });\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"]}
|
|
1
|
+
{"version":3,"sources":["../src/bus.ts","../src/errors.ts","../src/types.ts","../src/browser-lifecycle.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\nexport interface RealtimeTool {\n type: \"function\";\n name: string;\n description: string;\n parameters: {\n type: \"object\";\n properties: Record<string, unknown>;\n required?: string[];\n };\n}\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?: RealtimeTool[];\n toolChoice?: RealtimeToolChoice;\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 RealtimeToolContext {\n character?: Character | null;\n state: RealtimeState;\n callId?: string;\n}\n\nexport type RealtimeToolHandler = (\n args: Record<string, unknown>,\n context: RealtimeToolContext,\n) => Promise<Record<string, unknown>>;\n\nexport interface RealtimeToolRegistration {\n definition: RealtimeTool;\n handler: RealtimeToolHandler;\n timeoutMs?: number;\n}\n\nexport interface RealtimeUsageEvent {\n usage: Record<string, unknown>;\n model?: string;\n responseId?: string;\n}\n\nexport interface LLMAdapter {\n generateResponse(message: Message): Promise<string>;\n setCharacter(character: Character): void;\n clearHistory(): void;\n}\n\n// LLM 제공자 (서버사이드에서 LLM 응답 생성)\nexport interface LLMProvider {\n generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string>;\n}\n\n// 단순한 LLM 호출 클라이언트 (stateless)\nexport interface LLMClient {\n call(messages: Array<{ role: string; content: string }>): Promise<string>;\n}\n\n// LLM 매니저 (세션 관리, 히스토리, 캐릭터 관리)\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}\n\n// Renderer 인터페이스 (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 매니저 (세션 관리, 립싱크, 모션 제어)\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 setEventBus(eventBus: CharivoEventBus): void;\n prepareAudio?(): Promise<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 플레이어 (브라우저에서 음성 재생)\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 // Stateless audio generation (optional)\n generateAudio?(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n}\n\n// TTS 제공자 (오디오 데이터 생성)\nexport interface TTSProvider {\n generateSpeech(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n setVoice(voice: string): void;\n}\n\n// TTS Manager - TTS 세션의 상태 관리를 담당하는 인터페이스\nexport interface TTSManager {\n speak(text: string, options?: TTSOptions): Promise<void>;\n stop(): Promise<void>;\n setVoice(voice: string): void;\n isSupported(): boolean;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): 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}\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 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: RealtimeToolRegistration): void;\n unregisterTool(name: string): void;\n getRegisteredTools(): RealtimeTool[];\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\": { audioElement?: HTMLAudioElement; characterId?: string };\n \"tts:audio:end\": { characterId?: string };\n \"tts:lipsync:update\": { rms: number; characterId?: string };\n \"stt:start\": { options?: STTOptions };\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 \"realtime:expression\": { expressionId: string };\n \"realtime:motion\": { group: string; index: number };\n \"realtime: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","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 * from \"./bus\";\nexport * from \"./browser-lifecycle\";\nexport * from \"./errors\";\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 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\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 = 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 * 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\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 this.detachRenderer();\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
|
@@ -126,6 +126,11 @@ interface RealtimeToolRegistration {
|
|
|
126
126
|
handler: RealtimeToolHandler;
|
|
127
127
|
timeoutMs?: number;
|
|
128
128
|
}
|
|
129
|
+
interface RealtimeUsageEvent {
|
|
130
|
+
usage: Record<string, unknown>;
|
|
131
|
+
model?: string;
|
|
132
|
+
responseId?: string;
|
|
133
|
+
}
|
|
129
134
|
interface LLMAdapter {
|
|
130
135
|
generateResponse(message: Message): Promise<string>;
|
|
131
136
|
setCharacter(character: Character): void;
|
|
@@ -333,6 +338,7 @@ type EventMap = {
|
|
|
333
338
|
cause: RealtimeReconnectCause;
|
|
334
339
|
lastError: Error;
|
|
335
340
|
};
|
|
341
|
+
"realtime:usage": RealtimeUsageEvent;
|
|
336
342
|
"realtime:expression": {
|
|
337
343
|
expressionId: string;
|
|
338
344
|
};
|
|
@@ -376,6 +382,34 @@ interface BrowserLifecycleCallbacks {
|
|
|
376
382
|
}
|
|
377
383
|
declare function subscribeBrowserLifecycle(callbacks: BrowserLifecycleCallbacks): () => void;
|
|
378
384
|
|
|
385
|
+
type CharivoErrorCode = "CHARIVO_ERROR" | "CHARIVO_STATE_ERROR" | "CHARIVO_TIMEOUT_ERROR" | "CHARIVO_TRANSPORT_ERROR" | "CHARIVO_PROVIDER_ERROR" | "CHARIVO_DISPOSE_ERROR";
|
|
386
|
+
interface CharivoErrorOptions extends ErrorOptions {
|
|
387
|
+
code?: CharivoErrorCode;
|
|
388
|
+
}
|
|
389
|
+
declare class CharivoError extends Error {
|
|
390
|
+
readonly code: CharivoErrorCode;
|
|
391
|
+
constructor(message: string, options?: CharivoErrorOptions);
|
|
392
|
+
}
|
|
393
|
+
declare class CharivoStateError extends CharivoError {
|
|
394
|
+
constructor(message: string, options?: ErrorOptions);
|
|
395
|
+
}
|
|
396
|
+
declare class CharivoTimeoutError extends CharivoError {
|
|
397
|
+
constructor(message: string, options?: ErrorOptions);
|
|
398
|
+
}
|
|
399
|
+
declare class CharivoTransportError extends CharivoError {
|
|
400
|
+
constructor(message: string, options?: ErrorOptions);
|
|
401
|
+
}
|
|
402
|
+
declare class CharivoProviderError extends CharivoError {
|
|
403
|
+
constructor(message: string, options?: ErrorOptions);
|
|
404
|
+
}
|
|
405
|
+
declare class CharivoDisposeError extends CharivoError {
|
|
406
|
+
constructor(message: string, options?: ErrorOptions);
|
|
407
|
+
}
|
|
408
|
+
type CharivoErrorKind = "state" | "timeout" | "transport" | "provider" | "dispose";
|
|
409
|
+
declare function isCharivoError(error: unknown): error is CharivoError;
|
|
410
|
+
declare function getErrorMessage(error: unknown, fallback?: string): string;
|
|
411
|
+
declare function toCharivoError(kind: CharivoErrorKind, error: unknown, fallbackMessage?: string): CharivoError;
|
|
412
|
+
|
|
379
413
|
declare class Charivo {
|
|
380
414
|
private eventBus;
|
|
381
415
|
private llmManager?;
|
|
@@ -418,6 +452,14 @@ declare class Charivo {
|
|
|
418
452
|
* Detach the STT manager to disable speech recognition.
|
|
419
453
|
*/
|
|
420
454
|
detachSTT(): void;
|
|
455
|
+
/**
|
|
456
|
+
* Detach the LLM manager to disable chat completions.
|
|
457
|
+
*/
|
|
458
|
+
detachLLM(): void;
|
|
459
|
+
/**
|
|
460
|
+
* Detach the render manager without destroying it.
|
|
461
|
+
*/
|
|
462
|
+
detachRenderer(): void;
|
|
421
463
|
/**
|
|
422
464
|
* Connects the TTS manager to the event bus for audio event emission.
|
|
423
465
|
*/
|
|
@@ -489,6 +531,8 @@ declare class Charivo {
|
|
|
489
531
|
* Emit events to the event bus.
|
|
490
532
|
*/
|
|
491
533
|
emit<K extends keyof EventMap>(event: K, data: EventMap[K]): void;
|
|
534
|
+
dispose(): Promise<void>;
|
|
535
|
+
private finishDispose;
|
|
492
536
|
}
|
|
493
537
|
|
|
494
|
-
export { type AvatarControlCatalog, type BrowserLifecycleCallbacks, type Character, Charivo, type CharivoConfig, type CharivoEventBus, type CharivoEventEmitter, type Conversation, EventBus, type EventMap, type GazeCoordinates, type LLMAdapter, type LLMClient, type LLMManager, type LLMProvider, 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 RealtimeTool, type RealtimeToolChoice, type RealtimeToolContext, type RealtimeToolHandler, type RealtimeToolRegistration, type RealtimeTransportKind, type RenderManager, type Renderer, type STTManager, type STTOptions, type STTProvider, type STTTranscriber, type TTSManager, type TTSOptions, type TTSPlaybackMode, type TTSPlayer, type TTSProvider, subscribeBrowserLifecycle };
|
|
538
|
+
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 LLMProvider, 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 RealtimeTool, type RealtimeToolChoice, type RealtimeToolContext, type RealtimeToolHandler, type RealtimeToolRegistration, 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, getErrorMessage, isCharivoError, subscribeBrowserLifecycle, toCharivoError };
|
package/dist/index.d.ts
CHANGED
|
@@ -126,6 +126,11 @@ interface RealtimeToolRegistration {
|
|
|
126
126
|
handler: RealtimeToolHandler;
|
|
127
127
|
timeoutMs?: number;
|
|
128
128
|
}
|
|
129
|
+
interface RealtimeUsageEvent {
|
|
130
|
+
usage: Record<string, unknown>;
|
|
131
|
+
model?: string;
|
|
132
|
+
responseId?: string;
|
|
133
|
+
}
|
|
129
134
|
interface LLMAdapter {
|
|
130
135
|
generateResponse(message: Message): Promise<string>;
|
|
131
136
|
setCharacter(character: Character): void;
|
|
@@ -333,6 +338,7 @@ type EventMap = {
|
|
|
333
338
|
cause: RealtimeReconnectCause;
|
|
334
339
|
lastError: Error;
|
|
335
340
|
};
|
|
341
|
+
"realtime:usage": RealtimeUsageEvent;
|
|
336
342
|
"realtime:expression": {
|
|
337
343
|
expressionId: string;
|
|
338
344
|
};
|
|
@@ -376,6 +382,34 @@ interface BrowserLifecycleCallbacks {
|
|
|
376
382
|
}
|
|
377
383
|
declare function subscribeBrowserLifecycle(callbacks: BrowserLifecycleCallbacks): () => void;
|
|
378
384
|
|
|
385
|
+
type CharivoErrorCode = "CHARIVO_ERROR" | "CHARIVO_STATE_ERROR" | "CHARIVO_TIMEOUT_ERROR" | "CHARIVO_TRANSPORT_ERROR" | "CHARIVO_PROVIDER_ERROR" | "CHARIVO_DISPOSE_ERROR";
|
|
386
|
+
interface CharivoErrorOptions extends ErrorOptions {
|
|
387
|
+
code?: CharivoErrorCode;
|
|
388
|
+
}
|
|
389
|
+
declare class CharivoError extends Error {
|
|
390
|
+
readonly code: CharivoErrorCode;
|
|
391
|
+
constructor(message: string, options?: CharivoErrorOptions);
|
|
392
|
+
}
|
|
393
|
+
declare class CharivoStateError extends CharivoError {
|
|
394
|
+
constructor(message: string, options?: ErrorOptions);
|
|
395
|
+
}
|
|
396
|
+
declare class CharivoTimeoutError extends CharivoError {
|
|
397
|
+
constructor(message: string, options?: ErrorOptions);
|
|
398
|
+
}
|
|
399
|
+
declare class CharivoTransportError extends CharivoError {
|
|
400
|
+
constructor(message: string, options?: ErrorOptions);
|
|
401
|
+
}
|
|
402
|
+
declare class CharivoProviderError extends CharivoError {
|
|
403
|
+
constructor(message: string, options?: ErrorOptions);
|
|
404
|
+
}
|
|
405
|
+
declare class CharivoDisposeError extends CharivoError {
|
|
406
|
+
constructor(message: string, options?: ErrorOptions);
|
|
407
|
+
}
|
|
408
|
+
type CharivoErrorKind = "state" | "timeout" | "transport" | "provider" | "dispose";
|
|
409
|
+
declare function isCharivoError(error: unknown): error is CharivoError;
|
|
410
|
+
declare function getErrorMessage(error: unknown, fallback?: string): string;
|
|
411
|
+
declare function toCharivoError(kind: CharivoErrorKind, error: unknown, fallbackMessage?: string): CharivoError;
|
|
412
|
+
|
|
379
413
|
declare class Charivo {
|
|
380
414
|
private eventBus;
|
|
381
415
|
private llmManager?;
|
|
@@ -418,6 +452,14 @@ declare class Charivo {
|
|
|
418
452
|
* Detach the STT manager to disable speech recognition.
|
|
419
453
|
*/
|
|
420
454
|
detachSTT(): void;
|
|
455
|
+
/**
|
|
456
|
+
* Detach the LLM manager to disable chat completions.
|
|
457
|
+
*/
|
|
458
|
+
detachLLM(): void;
|
|
459
|
+
/**
|
|
460
|
+
* Detach the render manager without destroying it.
|
|
461
|
+
*/
|
|
462
|
+
detachRenderer(): void;
|
|
421
463
|
/**
|
|
422
464
|
* Connects the TTS manager to the event bus for audio event emission.
|
|
423
465
|
*/
|
|
@@ -489,6 +531,8 @@ declare class Charivo {
|
|
|
489
531
|
* Emit events to the event bus.
|
|
490
532
|
*/
|
|
491
533
|
emit<K extends keyof EventMap>(event: K, data: EventMap[K]): void;
|
|
534
|
+
dispose(): Promise<void>;
|
|
535
|
+
private finishDispose;
|
|
492
536
|
}
|
|
493
537
|
|
|
494
|
-
export { type AvatarControlCatalog, type BrowserLifecycleCallbacks, type Character, Charivo, type CharivoConfig, type CharivoEventBus, type CharivoEventEmitter, type Conversation, EventBus, type EventMap, type GazeCoordinates, type LLMAdapter, type LLMClient, type LLMManager, type LLMProvider, 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 RealtimeTool, type RealtimeToolChoice, type RealtimeToolContext, type RealtimeToolHandler, type RealtimeToolRegistration, type RealtimeTransportKind, type RenderManager, type Renderer, type STTManager, type STTOptions, type STTProvider, type STTTranscriber, type TTSManager, type TTSOptions, type TTSPlaybackMode, type TTSPlayer, type TTSProvider, subscribeBrowserLifecycle };
|
|
538
|
+
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 LLMProvider, 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 RealtimeTool, type RealtimeToolChoice, type RealtimeToolContext, type RealtimeToolHandler, type RealtimeToolRegistration, 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, getErrorMessage, isCharivoError, subscribeBrowserLifecycle, toCharivoError };
|
package/dist/index.js
CHANGED
|
@@ -26,6 +26,94 @@ var EventBus = class {
|
|
|
26
26
|
}
|
|
27
27
|
};
|
|
28
28
|
|
|
29
|
+
// src/errors.ts
|
|
30
|
+
var CharivoError = class extends Error {
|
|
31
|
+
code;
|
|
32
|
+
constructor(message, options = {}) {
|
|
33
|
+
super(message, options);
|
|
34
|
+
this.name = "CharivoError";
|
|
35
|
+
this.code = options.code ?? "CHARIVO_ERROR";
|
|
36
|
+
}
|
|
37
|
+
};
|
|
38
|
+
var CharivoStateError = class extends CharivoError {
|
|
39
|
+
constructor(message, options = {}) {
|
|
40
|
+
super(message, {
|
|
41
|
+
...options,
|
|
42
|
+
code: "CHARIVO_STATE_ERROR"
|
|
43
|
+
});
|
|
44
|
+
this.name = "CharivoStateError";
|
|
45
|
+
}
|
|
46
|
+
};
|
|
47
|
+
var CharivoTimeoutError = class extends CharivoError {
|
|
48
|
+
constructor(message, options = {}) {
|
|
49
|
+
super(message, {
|
|
50
|
+
...options,
|
|
51
|
+
code: "CHARIVO_TIMEOUT_ERROR"
|
|
52
|
+
});
|
|
53
|
+
this.name = "CharivoTimeoutError";
|
|
54
|
+
}
|
|
55
|
+
};
|
|
56
|
+
var CharivoTransportError = class extends CharivoError {
|
|
57
|
+
constructor(message, options = {}) {
|
|
58
|
+
super(message, {
|
|
59
|
+
...options,
|
|
60
|
+
code: "CHARIVO_TRANSPORT_ERROR"
|
|
61
|
+
});
|
|
62
|
+
this.name = "CharivoTransportError";
|
|
63
|
+
}
|
|
64
|
+
};
|
|
65
|
+
var CharivoProviderError = class extends CharivoError {
|
|
66
|
+
constructor(message, options = {}) {
|
|
67
|
+
super(message, {
|
|
68
|
+
...options,
|
|
69
|
+
code: "CHARIVO_PROVIDER_ERROR"
|
|
70
|
+
});
|
|
71
|
+
this.name = "CharivoProviderError";
|
|
72
|
+
}
|
|
73
|
+
};
|
|
74
|
+
var CharivoDisposeError = class extends CharivoError {
|
|
75
|
+
constructor(message, options = {}) {
|
|
76
|
+
super(message, {
|
|
77
|
+
...options,
|
|
78
|
+
code: "CHARIVO_DISPOSE_ERROR"
|
|
79
|
+
});
|
|
80
|
+
this.name = "CharivoDisposeError";
|
|
81
|
+
}
|
|
82
|
+
};
|
|
83
|
+
function isCharivoError(error) {
|
|
84
|
+
return error instanceof CharivoError;
|
|
85
|
+
}
|
|
86
|
+
function getErrorMessage(error, fallback = "Unknown error") {
|
|
87
|
+
if (typeof error === "string" && error.trim().length > 0) {
|
|
88
|
+
return error;
|
|
89
|
+
}
|
|
90
|
+
if (error instanceof Error && error.message.trim().length > 0) {
|
|
91
|
+
return error.message;
|
|
92
|
+
}
|
|
93
|
+
return fallback;
|
|
94
|
+
}
|
|
95
|
+
function toCharivoError(kind, error, fallbackMessage) {
|
|
96
|
+
if (isCharivoError(error)) {
|
|
97
|
+
return error;
|
|
98
|
+
}
|
|
99
|
+
const message = getErrorMessage(error, fallbackMessage);
|
|
100
|
+
const options = error instanceof Error ? {
|
|
101
|
+
cause: error
|
|
102
|
+
} : void 0;
|
|
103
|
+
switch (kind) {
|
|
104
|
+
case "state":
|
|
105
|
+
return new CharivoStateError(message, options);
|
|
106
|
+
case "timeout":
|
|
107
|
+
return new CharivoTimeoutError(message, options);
|
|
108
|
+
case "transport":
|
|
109
|
+
return new CharivoTransportError(message, options);
|
|
110
|
+
case "provider":
|
|
111
|
+
return new CharivoProviderError(message, options);
|
|
112
|
+
case "dispose":
|
|
113
|
+
return new CharivoDisposeError(message, options);
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
|
|
29
117
|
// src/types.ts
|
|
30
118
|
var OPENAI_REALTIME_ADAPTER = "openai-webrtc";
|
|
31
119
|
var OPENAI_REALTIME_AGENTS_ADAPTER = "openai-agents-webrtc";
|
|
@@ -159,6 +247,18 @@ var Charivo = class {
|
|
|
159
247
|
detachSTT() {
|
|
160
248
|
this.sttManager = void 0;
|
|
161
249
|
}
|
|
250
|
+
/**
|
|
251
|
+
* Detach the LLM manager to disable chat completions.
|
|
252
|
+
*/
|
|
253
|
+
detachLLM() {
|
|
254
|
+
this.llmManager = void 0;
|
|
255
|
+
}
|
|
256
|
+
/**
|
|
257
|
+
* Detach the render manager without destroying it.
|
|
258
|
+
*/
|
|
259
|
+
detachRenderer() {
|
|
260
|
+
this.renderManager = void 0;
|
|
261
|
+
}
|
|
162
262
|
/**
|
|
163
263
|
* Connects the TTS manager to the event bus for audio event emission.
|
|
164
264
|
*/
|
|
@@ -204,10 +304,22 @@ var Charivo = class {
|
|
|
204
304
|
};
|
|
205
305
|
this.eventBus.emit("message:sent", { message: userMessage });
|
|
206
306
|
if (this.renderManager) {
|
|
207
|
-
|
|
307
|
+
try {
|
|
308
|
+
await this.renderManager.render(userMessage);
|
|
309
|
+
} catch (error) {
|
|
310
|
+
throw toCharivoError("state", error, "Failed to render user message");
|
|
311
|
+
}
|
|
208
312
|
}
|
|
209
313
|
if (this.llmManager && this.character) {
|
|
210
|
-
const response = await this.llmManager.generateResponse(userMessage)
|
|
314
|
+
const response = await this.llmManager.generateResponse(userMessage).catch(
|
|
315
|
+
(error) => Promise.reject(
|
|
316
|
+
toCharivoError(
|
|
317
|
+
"provider",
|
|
318
|
+
error,
|
|
319
|
+
"Failed to generate a character response"
|
|
320
|
+
)
|
|
321
|
+
)
|
|
322
|
+
);
|
|
211
323
|
const characterMessage = {
|
|
212
324
|
id: Date.now().toString() + "_response",
|
|
213
325
|
content: response,
|
|
@@ -221,7 +333,15 @@ var Charivo = class {
|
|
|
221
333
|
message: response
|
|
222
334
|
});
|
|
223
335
|
if (this.renderManager) {
|
|
224
|
-
|
|
336
|
+
try {
|
|
337
|
+
await this.renderManager.render(characterMessage, this.character);
|
|
338
|
+
} catch (error) {
|
|
339
|
+
throw toCharivoError(
|
|
340
|
+
"state",
|
|
341
|
+
error,
|
|
342
|
+
"Failed to render character response"
|
|
343
|
+
);
|
|
344
|
+
}
|
|
225
345
|
}
|
|
226
346
|
if (this.ttsManager) {
|
|
227
347
|
try {
|
|
@@ -238,7 +358,8 @@ var Charivo = class {
|
|
|
238
358
|
await this.ttsManager.speak(response, ttsOptions);
|
|
239
359
|
this.eventBus.emit("tts:end", { characterId: this.character.id });
|
|
240
360
|
} catch (error) {
|
|
241
|
-
|
|
361
|
+
const typedError = toCharivoError("provider", error);
|
|
362
|
+
this.eventBus.emit("tts:error", { error: typedError });
|
|
242
363
|
}
|
|
243
364
|
}
|
|
244
365
|
}
|
|
@@ -332,8 +453,68 @@ var Charivo = class {
|
|
|
332
453
|
emit(event, data) {
|
|
333
454
|
this.eventBus.emit(event, data);
|
|
334
455
|
}
|
|
456
|
+
async dispose() {
|
|
457
|
+
let firstError = null;
|
|
458
|
+
const recordError = (error, fallbackMessage) => {
|
|
459
|
+
const typedError = toCharivoError("dispose", error, fallbackMessage);
|
|
460
|
+
if (!firstError) {
|
|
461
|
+
firstError = typedError;
|
|
462
|
+
}
|
|
463
|
+
};
|
|
464
|
+
if (this.realtimeManager) {
|
|
465
|
+
try {
|
|
466
|
+
await this.realtimeManager.stopSession();
|
|
467
|
+
} catch (error) {
|
|
468
|
+
recordError(error, "Failed to stop realtime session during dispose");
|
|
469
|
+
}
|
|
470
|
+
}
|
|
471
|
+
if (this.ttsManager) {
|
|
472
|
+
try {
|
|
473
|
+
await this.ttsManager.stop();
|
|
474
|
+
} catch (error) {
|
|
475
|
+
recordError(error, "Failed to stop TTS during dispose");
|
|
476
|
+
}
|
|
477
|
+
}
|
|
478
|
+
if (this.sttManager) {
|
|
479
|
+
try {
|
|
480
|
+
if (this.sttManager.isRecording()) {
|
|
481
|
+
await this.sttManager.stop();
|
|
482
|
+
}
|
|
483
|
+
} catch (error) {
|
|
484
|
+
recordError(error, "Failed to stop STT during dispose");
|
|
485
|
+
}
|
|
486
|
+
}
|
|
487
|
+
if (this.renderManager) {
|
|
488
|
+
try {
|
|
489
|
+
await this.renderManager.destroy();
|
|
490
|
+
} catch (error) {
|
|
491
|
+
recordError(error, "Failed to destroy renderer during dispose");
|
|
492
|
+
}
|
|
493
|
+
}
|
|
494
|
+
if (this.llmManager) {
|
|
495
|
+
try {
|
|
496
|
+
this.llmManager.clearHistory();
|
|
497
|
+
} catch (error) {
|
|
498
|
+
recordError(error, "Failed to clear LLM history during dispose");
|
|
499
|
+
}
|
|
500
|
+
}
|
|
501
|
+
this.detachRealtime();
|
|
502
|
+
this.detachTTS();
|
|
503
|
+
this.detachSTT();
|
|
504
|
+
this.detachLLM();
|
|
505
|
+
this.detachRenderer();
|
|
506
|
+
this.character = void 0;
|
|
507
|
+
this.isRealtimeMode = false;
|
|
508
|
+
this.eventBus.clear();
|
|
509
|
+
return this.finishDispose(firstError);
|
|
510
|
+
}
|
|
511
|
+
finishDispose(firstError) {
|
|
512
|
+
if (firstError) {
|
|
513
|
+
throw firstError;
|
|
514
|
+
}
|
|
515
|
+
}
|
|
335
516
|
};
|
|
336
517
|
|
|
337
|
-
export { Charivo, EventBus, OPENAI_REALTIME_ADAPTER, OPENAI_REALTIME_AGENTS_ADAPTER, subscribeBrowserLifecycle };
|
|
518
|
+
export { Charivo, CharivoDisposeError, CharivoError, CharivoProviderError, CharivoStateError, CharivoTimeoutError, CharivoTransportError, EventBus, OPENAI_REALTIME_ADAPTER, OPENAI_REALTIME_AGENTS_ADAPTER, getErrorMessage, isCharivoError, subscribeBrowserLifecycle, toCharivoError };
|
|
338
519
|
//# sourceMappingURL=index.js.map
|
|
339
520
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/bus.ts","../src/types.ts","../src/browser-lifecycle.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 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\nexport interface RealtimeTool {\n type: \"function\";\n name: string;\n description: string;\n parameters: {\n type: \"object\";\n properties: Record<string, unknown>;\n required?: string[];\n };\n}\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?: RealtimeTool[];\n toolChoice?: RealtimeToolChoice;\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 RealtimeToolContext {\n character?: Character | null;\n state: RealtimeState;\n callId?: string;\n}\n\nexport type RealtimeToolHandler = (\n args: Record<string, unknown>,\n context: RealtimeToolContext,\n) => Promise<Record<string, unknown>>;\n\nexport interface RealtimeToolRegistration {\n definition: RealtimeTool;\n handler: RealtimeToolHandler;\n timeoutMs?: number;\n}\n\nexport interface LLMAdapter {\n generateResponse(message: Message): Promise<string>;\n setCharacter(character: Character): void;\n clearHistory(): void;\n}\n\n// LLM 제공자 (서버사이드에서 LLM 응답 생성)\nexport interface LLMProvider {\n generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string>;\n}\n\n// 단순한 LLM 호출 클라이언트 (stateless)\nexport interface LLMClient {\n call(messages: Array<{ role: string; content: string }>): Promise<string>;\n}\n\n// LLM 매니저 (세션 관리, 히스토리, 캐릭터 관리)\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}\n\n// Renderer 인터페이스 (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 매니저 (세션 관리, 립싱크, 모션 제어)\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 setEventBus(eventBus: CharivoEventBus): void;\n prepareAudio?(): Promise<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 플레이어 (브라우저에서 음성 재생)\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 // Stateless audio generation (optional)\n generateAudio?(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n}\n\n// TTS 제공자 (오디오 데이터 생성)\nexport interface TTSProvider {\n generateSpeech(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n setVoice(voice: string): void;\n}\n\n// TTS Manager - TTS 세션의 상태 관리를 담당하는 인터페이스\nexport interface TTSManager {\n speak(text: string, options?: TTSOptions): Promise<void>;\n stop(): Promise<void>;\n setVoice(voice: string): void;\n isSupported(): boolean;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): 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}\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 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: RealtimeToolRegistration): void;\n unregisterTool(name: string): void;\n getRegisteredTools(): RealtimeTool[];\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\": { audioElement?: HTMLAudioElement; characterId?: string };\n \"tts:audio:end\": { characterId?: string };\n \"tts:lipsync:update\": { rms: number; characterId?: string };\n \"stt:start\": { options?: STTOptions };\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:expression\": { expressionId: string };\n \"realtime:motion\": { group: string; index: number };\n \"realtime: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","import { EventBus } from \"./bus\";\nimport {\n Character,\n Message,\n RenderManager,\n TTSManager,\n STTManager,\n LLMManager,\n} from \"./types\";\n\nexport * from \"./types\";\nexport * from \"./bus\";\nexport * from \"./browser-lifecycle\";\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 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\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 * 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 * 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 await this.renderManager.render(userMessage);\n }\n\n // Generate and render character response\n if (this.llmManager && this.character) {\n const response = await this.llmManager.generateResponse(userMessage);\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 await this.renderManager.render(characterMessage, this.character);\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 this.eventBus.emit(\"tts:error\", { error: error as Error });\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"]}
|
|
1
|
+
{"version":3,"sources":["../src/bus.ts","../src/errors.ts","../src/types.ts","../src/browser-lifecycle.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\nexport interface RealtimeTool {\n type: \"function\";\n name: string;\n description: string;\n parameters: {\n type: \"object\";\n properties: Record<string, unknown>;\n required?: string[];\n };\n}\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?: RealtimeTool[];\n toolChoice?: RealtimeToolChoice;\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 RealtimeToolContext {\n character?: Character | null;\n state: RealtimeState;\n callId?: string;\n}\n\nexport type RealtimeToolHandler = (\n args: Record<string, unknown>,\n context: RealtimeToolContext,\n) => Promise<Record<string, unknown>>;\n\nexport interface RealtimeToolRegistration {\n definition: RealtimeTool;\n handler: RealtimeToolHandler;\n timeoutMs?: number;\n}\n\nexport interface RealtimeUsageEvent {\n usage: Record<string, unknown>;\n model?: string;\n responseId?: string;\n}\n\nexport interface LLMAdapter {\n generateResponse(message: Message): Promise<string>;\n setCharacter(character: Character): void;\n clearHistory(): void;\n}\n\n// LLM 제공자 (서버사이드에서 LLM 응답 생성)\nexport interface LLMProvider {\n generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string>;\n}\n\n// 단순한 LLM 호출 클라이언트 (stateless)\nexport interface LLMClient {\n call(messages: Array<{ role: string; content: string }>): Promise<string>;\n}\n\n// LLM 매니저 (세션 관리, 히스토리, 캐릭터 관리)\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}\n\n// Renderer 인터페이스 (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 매니저 (세션 관리, 립싱크, 모션 제어)\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 setEventBus(eventBus: CharivoEventBus): void;\n prepareAudio?(): Promise<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 플레이어 (브라우저에서 음성 재생)\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 // Stateless audio generation (optional)\n generateAudio?(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n}\n\n// TTS 제공자 (오디오 데이터 생성)\nexport interface TTSProvider {\n generateSpeech(text: string, options?: TTSOptions): Promise<ArrayBuffer>;\n setVoice(voice: string): void;\n}\n\n// TTS Manager - TTS 세션의 상태 관리를 담당하는 인터페이스\nexport interface TTSManager {\n speak(text: string, options?: TTSOptions): Promise<void>;\n stop(): Promise<void>;\n setVoice(voice: string): void;\n isSupported(): boolean;\n setEventEmitter?(eventEmitter: CharivoEventEmitter): 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}\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 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: RealtimeToolRegistration): void;\n unregisterTool(name: string): void;\n getRegisteredTools(): RealtimeTool[];\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\": { audioElement?: HTMLAudioElement; characterId?: string };\n \"tts:audio:end\": { characterId?: string };\n \"tts:lipsync:update\": { rms: number; characterId?: string };\n \"stt:start\": { options?: STTOptions };\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 \"realtime:expression\": { expressionId: string };\n \"realtime:motion\": { group: string; index: number };\n \"realtime: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","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 * from \"./bus\";\nexport * from \"./browser-lifecycle\";\nexport * from \"./errors\";\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 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\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 = 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 * 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\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 this.detachRenderer();\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"]}
|