@charivo/realtime 0.2.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.
@@ -0,0 +1,88 @@
1
+ import { R as RealtimeTransportClient } from './types-DntfJo0o.mjs';
2
+ export { b as RealtimeClient, a as RealtimeTransportEvent } from './types-DntfJo0o.mjs';
3
+ import { RealtimeSessionConfig, RealtimeToolRegistration, RealtimeManager, CharivoEventEmitter, Character, RealtimeTool, RealtimeState, MotionSelection, GazeCoordinates, AvatarControlCatalog } from '@charivo/core';
4
+ export { Character, CharivoEventEmitter, RealtimeConnectionState, RealtimeManager, RealtimeProvider, RealtimeResponseStatus, RealtimeSessionBootstrap, RealtimeSessionConfig, RealtimeSessionRequest, RealtimeSessionStatus, RealtimeSessionTransitionReason, RealtimeState, RealtimeTool, RealtimeToolChoice, RealtimeToolContext, RealtimeToolHandler, RealtimeToolRegistration, RealtimeTransportKind } from '@charivo/core';
5
+
6
+ interface RealtimeManagerOptions {
7
+ defaultSessionConfig?: Omit<RealtimeSessionConfig, "tools">;
8
+ tools?: RealtimeToolRegistration[];
9
+ defaultToolTimeoutMs?: number;
10
+ }
11
+ /**
12
+ * Provider-agnostic realtime manager.
13
+ *
14
+ * It owns session state, character-aware session config generation, tool
15
+ * execution, and event relaying. Transport-specific event parsing belongs to
16
+ * concrete client packages such as `@charivo/realtime/openai`.
17
+ */
18
+ declare class RealtimeManagerImpl implements RealtimeManager {
19
+ private client;
20
+ private options;
21
+ private eventEmitter?;
22
+ private character;
23
+ private isStoppingSession;
24
+ private isRefreshingSession;
25
+ private isAudioPlaybackActive;
26
+ private sessionBaseConfig?;
27
+ private refreshInFlight;
28
+ private hasQueuedRefresh;
29
+ private stopRequestedDuringRefresh;
30
+ private emittedUserStopDuringRefresh;
31
+ private readonly toolRegistry;
32
+ private state;
33
+ constructor(client: RealtimeTransportClient, options?: RealtimeManagerOptions);
34
+ setEventEmitter(eventEmitter: CharivoEventEmitter): void;
35
+ setCharacter(character: Character): void;
36
+ registerTool(tool: RealtimeToolRegistration): void;
37
+ unregisterTool(name: string): void;
38
+ getRegisteredTools(): RealtimeTool[];
39
+ getState(): RealtimeState;
40
+ startSession(config?: RealtimeSessionConfig): Promise<void>;
41
+ updateSession(config?: RealtimeSessionConfig): Promise<void>;
42
+ stopSession(): Promise<void>;
43
+ sendMessage(text: string): Promise<void>;
44
+ sendAudioChunk(audio: ArrayBuffer): Promise<void>;
45
+ interrupt(): Promise<void>;
46
+ private handleClientEvent;
47
+ private executeToolCall;
48
+ private runToolHandler;
49
+ private handleToolExecutionFailure;
50
+ private postProcessToolResult;
51
+ private emitToolError;
52
+ private ensureResponseStarted;
53
+ private emitState;
54
+ private applyError;
55
+ private emitAudioStart;
56
+ private emitAudioEnd;
57
+ private resolveNextSessionBaseConfig;
58
+ private buildEffectiveSessionConfig;
59
+ private commitActiveSession;
60
+ private performStopSession;
61
+ private runRefreshLoop;
62
+ private performSessionRefresh;
63
+ private emitSessionStart;
64
+ private emitSessionEnd;
65
+ private finalizeFailedSession;
66
+ private finalizeStoppedSession;
67
+ }
68
+ declare function createRealtimeManager(client: RealtimeTransportClient, options?: RealtimeManagerOptions): RealtimeManager;
69
+
70
+ declare const SET_EXPRESSION_TOOL_NAME = "setExpression";
71
+ declare const PLAY_MOTION_TOOL_NAME = "playMotion";
72
+ declare const LOOK_AT_TOOL_NAME = "lookAt";
73
+ declare const AVATAR_CONTROL_TOOL_NAMES: readonly ["setExpression", "playMotion", "lookAt"];
74
+ interface ExpressionArgs {
75
+ expressionId: string;
76
+ }
77
+ type MotionArgs = MotionSelection;
78
+ type LookAtArgs = GazeCoordinates;
79
+ declare function createAvatarControlTools(catalog: AvatarControlCatalog): RealtimeToolRegistration[];
80
+
81
+ declare const DEFAULT_REALTIME_AGENT_INSTRUCTIONS: string;
82
+ interface BuildRealtimeSessionConfigOptions {
83
+ character?: Character | null;
84
+ baseConfig?: RealtimeSessionConfig;
85
+ }
86
+ declare function buildRealtimeSessionConfig({ character, baseConfig, }?: BuildRealtimeSessionConfigOptions): RealtimeSessionConfig;
87
+
88
+ export { AVATAR_CONTROL_TOOL_NAMES, type BuildRealtimeSessionConfigOptions, DEFAULT_REALTIME_AGENT_INSTRUCTIONS, type ExpressionArgs, LOOK_AT_TOOL_NAME, type LookAtArgs, type MotionArgs, PLAY_MOTION_TOOL_NAME, RealtimeManagerImpl, type RealtimeManagerOptions, RealtimeTransportClient, SET_EXPRESSION_TOOL_NAME, buildRealtimeSessionConfig, createAvatarControlTools, createRealtimeManager };
@@ -0,0 +1,88 @@
1
+ import { R as RealtimeTransportClient } from './types-DntfJo0o.js';
2
+ export { b as RealtimeClient, a as RealtimeTransportEvent } from './types-DntfJo0o.js';
3
+ import { RealtimeSessionConfig, RealtimeToolRegistration, RealtimeManager, CharivoEventEmitter, Character, RealtimeTool, RealtimeState, MotionSelection, GazeCoordinates, AvatarControlCatalog } from '@charivo/core';
4
+ export { Character, CharivoEventEmitter, RealtimeConnectionState, RealtimeManager, RealtimeProvider, RealtimeResponseStatus, RealtimeSessionBootstrap, RealtimeSessionConfig, RealtimeSessionRequest, RealtimeSessionStatus, RealtimeSessionTransitionReason, RealtimeState, RealtimeTool, RealtimeToolChoice, RealtimeToolContext, RealtimeToolHandler, RealtimeToolRegistration, RealtimeTransportKind } from '@charivo/core';
5
+
6
+ interface RealtimeManagerOptions {
7
+ defaultSessionConfig?: Omit<RealtimeSessionConfig, "tools">;
8
+ tools?: RealtimeToolRegistration[];
9
+ defaultToolTimeoutMs?: number;
10
+ }
11
+ /**
12
+ * Provider-agnostic realtime manager.
13
+ *
14
+ * It owns session state, character-aware session config generation, tool
15
+ * execution, and event relaying. Transport-specific event parsing belongs to
16
+ * concrete client packages such as `@charivo/realtime/openai`.
17
+ */
18
+ declare class RealtimeManagerImpl implements RealtimeManager {
19
+ private client;
20
+ private options;
21
+ private eventEmitter?;
22
+ private character;
23
+ private isStoppingSession;
24
+ private isRefreshingSession;
25
+ private isAudioPlaybackActive;
26
+ private sessionBaseConfig?;
27
+ private refreshInFlight;
28
+ private hasQueuedRefresh;
29
+ private stopRequestedDuringRefresh;
30
+ private emittedUserStopDuringRefresh;
31
+ private readonly toolRegistry;
32
+ private state;
33
+ constructor(client: RealtimeTransportClient, options?: RealtimeManagerOptions);
34
+ setEventEmitter(eventEmitter: CharivoEventEmitter): void;
35
+ setCharacter(character: Character): void;
36
+ registerTool(tool: RealtimeToolRegistration): void;
37
+ unregisterTool(name: string): void;
38
+ getRegisteredTools(): RealtimeTool[];
39
+ getState(): RealtimeState;
40
+ startSession(config?: RealtimeSessionConfig): Promise<void>;
41
+ updateSession(config?: RealtimeSessionConfig): Promise<void>;
42
+ stopSession(): Promise<void>;
43
+ sendMessage(text: string): Promise<void>;
44
+ sendAudioChunk(audio: ArrayBuffer): Promise<void>;
45
+ interrupt(): Promise<void>;
46
+ private handleClientEvent;
47
+ private executeToolCall;
48
+ private runToolHandler;
49
+ private handleToolExecutionFailure;
50
+ private postProcessToolResult;
51
+ private emitToolError;
52
+ private ensureResponseStarted;
53
+ private emitState;
54
+ private applyError;
55
+ private emitAudioStart;
56
+ private emitAudioEnd;
57
+ private resolveNextSessionBaseConfig;
58
+ private buildEffectiveSessionConfig;
59
+ private commitActiveSession;
60
+ private performStopSession;
61
+ private runRefreshLoop;
62
+ private performSessionRefresh;
63
+ private emitSessionStart;
64
+ private emitSessionEnd;
65
+ private finalizeFailedSession;
66
+ private finalizeStoppedSession;
67
+ }
68
+ declare function createRealtimeManager(client: RealtimeTransportClient, options?: RealtimeManagerOptions): RealtimeManager;
69
+
70
+ declare const SET_EXPRESSION_TOOL_NAME = "setExpression";
71
+ declare const PLAY_MOTION_TOOL_NAME = "playMotion";
72
+ declare const LOOK_AT_TOOL_NAME = "lookAt";
73
+ declare const AVATAR_CONTROL_TOOL_NAMES: readonly ["setExpression", "playMotion", "lookAt"];
74
+ interface ExpressionArgs {
75
+ expressionId: string;
76
+ }
77
+ type MotionArgs = MotionSelection;
78
+ type LookAtArgs = GazeCoordinates;
79
+ declare function createAvatarControlTools(catalog: AvatarControlCatalog): RealtimeToolRegistration[];
80
+
81
+ declare const DEFAULT_REALTIME_AGENT_INSTRUCTIONS: string;
82
+ interface BuildRealtimeSessionConfigOptions {
83
+ character?: Character | null;
84
+ baseConfig?: RealtimeSessionConfig;
85
+ }
86
+ declare function buildRealtimeSessionConfig({ character, baseConfig, }?: BuildRealtimeSessionConfigOptions): RealtimeSessionConfig;
87
+
88
+ export { AVATAR_CONTROL_TOOL_NAMES, type BuildRealtimeSessionConfigOptions, DEFAULT_REALTIME_AGENT_INSTRUCTIONS, type ExpressionArgs, LOOK_AT_TOOL_NAME, type LookAtArgs, type MotionArgs, PLAY_MOTION_TOOL_NAME, RealtimeManagerImpl, type RealtimeManagerOptions, RealtimeTransportClient, SET_EXPRESSION_TOOL_NAME, buildRealtimeSessionConfig, createAvatarControlTools, createRealtimeManager };