@charivo/realtime-core 0.0.1 → 0.1.0

package/README.md

@@ -1,252 +1,48 @@
 # @charivo/realtime-core
 
-Core Realtime API functionality with session management and event relay for low-latency voice conversations.
+Realtime session manager and typed OpenAI Realtime helpers for Charivo.
 
-## Features
-
-- 🌐 **Session Management** - Start/stop Realtime API sessions
-- 📡 **Event Relay** - Bridge between Realtime client and Charivo event system
-- 💋 **Lip-Sync Support** - Real-time RMS values for character mouth animation
-- 🔌 **Client Agnostic** - Works with any Realtime client implementation
-
-## Installation
+## Install
 
 ```bash
-pnpm add @charivo/realtime-core @charivo/core
+pnpm add @charivo/realtime-core
 ```
 
 ## Usage
 
-### Basic Setup
-
-```typescript
-import { createRealtimeManager } from "@charivo/realtime-core";
+```ts
+import {
+  createRealtimeManager,
+  getEmotionSessionConfig,
+} from "@charivo/realtime-core";
 import { createOpenAIRealtimeClient } from "@charivo/realtime-client-openai";
 
-// Create a Realtime client
-const client = createOpenAIRealtimeClient({
-  apiEndpoint: "/api/realtime" // Your WebRTC handshake endpoint
-});
-
-// Wrap with RealtimeManager for state management
-const realtimeManager = createRealtimeManager(client);
-
-// Start Realtime session
-await realtimeManager.startSession({
-  model: "gpt-4o-realtime-preview-2024-12-17",
-  voice: "verse"
-});
-
-// Send text message
-await realtimeManager.sendMessage("Hello!");
-
-// Stop session when done
-await realtimeManager.stopSession();
-```
-
-### With Charivo Integration
-
-```typescript
-import { Charivo } from "@charivo/core";
-import { createRealtimeManager } from "@charivo/realtime-core";
-import { createOpenAIRealtimeClient } from "@charivo/realtime-client-openai";
-
-const charivo = new Charivo();
-
-// Create and attach Realtime manager
-const client = createOpenAIRealtimeClient({
-  apiEndpoint: "/api/realtime"
-});
-const realtimeManager = createRealtimeManager(client);
-charivo.attachRealtime(realtimeManager);
-
-// Start session
-await realtimeManager.startSession({
-  model: "gpt-4o-realtime-preview-2024-12-17",
-  voice: "verse"
-});
-
-// Enable lip-sync on renderer
-charivo.emit("tts:audio:start", { audioElement: new Audio() });
-
-// Listen to events
-charivo.on("realtime:text:delta", ({ text }) => {
-  console.log("Streaming text:", text);
-});
-
-charivo.on("tts:lipsync:update", ({ rms }) => {
-  console.log("Lip-sync RMS:", rms);
-});
-
-// Cleanup
-await realtimeManager.stopSession();
-charivo.emit("tts:audio:end", {});
-charivo.detachRealtime();
-```
-
-### Custom Realtime Client
-
-```typescript
-import { RealtimeClient } from "@charivo/realtime-core";
-import { createRealtimeManager } from "@charivo/realtime-core";
-
-class MyRealtimeClient implements RealtimeClient {
-  async connect(): Promise<void> {
-    // Connect to your Realtime service
-  }
-
-  async disconnect(): Promise<void> {
-    // Disconnect
-  }
-
-  async sendText(text: string): Promise<void> {
-    // Send text message
-  }
-
-  async sendAudio(audio: ArrayBuffer): Promise<void> {
-    // Send audio chunk
-  }
-
-  onTextDelta(callback: (text: string) => void): void {
-    // Register text streaming callback
-  }
-
-  onAudioDelta(callback: (base64Audio: string) => void): void {
-    // Register audio streaming callback
-  }
-
-  onLipSyncUpdate?(callback: (rms: number) => void): void {
-    // Optional: Register direct RMS callback for WebRTC clients
-  }
-
-  onAudioDone(callback: () => void): void {
-    // Register audio end callback
-  }
-
-  onError(callback: (error: Error) => void): void {
-    // Register error callback
-  }
-}
-
-const realtimeManager = createRealtimeManager(new MyRealtimeClient());
-```
-
-## API Reference
-
-### `RealtimeManager`
-
-#### Methods
-
-##### `setEventEmitter(eventEmitter)`
-
-Connect to Charivo's event system.
-
-**Parameters:**
-- `eventEmitter` - Object with `emit(event, data)` method
+const client = createOpenAIRealtimeClient({ apiEndpoint: "/api/realtime" });
+const manager = createRealtimeManager(client);
 
-##### `startSession(config)`
-
-Start a Realtime session.
-
-**Parameters:**
-- `config.model` - Model name (e.g., "gpt-4o-realtime-preview-2024-12-17")
-- `config.voice` - Voice name (e.g., "verse", "alloy", "echo")
-
-**Returns:** `Promise<void>`
-
-##### `stopSession()`
-
-Stop the current Realtime session.
-
-**Returns:** `Promise<void>`
-
-##### `sendMessage(text)`
-
-Send a text message to the Realtime API.
-
-**Parameters:**
-- `text` - Message text
-
-**Returns:** `Promise<void>`
-
-##### `sendAudioChunk(audio)`
-
-Send an audio chunk (user's voice).
-
-**Parameters:**
-- `audio` - Audio data as ArrayBuffer
-
-**Returns:** `Promise<void>`
-
-### Events
-
-When integrated with Charivo, the following events are emitted:
-
-#### `realtime:text:delta`
-
-Streamed text response from the AI.
-
-**Payload:**
-```typescript
-{ text: string }
+await manager.startSession(
+  getEmotionSessionConfig({
+    model: "gpt-realtime-mini",
+    voice: "marin",
+  }),
+);
 ```
 
-#### `tts:lipsync:update`
-
-Real-time lip-sync RMS values (0.0 - 1.0).
-
-**Payload:**
-```typescript
-{ rms: number }
-```
-
-#### `tts:audio:end`
-
-Audio playback finished.
-
-**Payload:**
-```typescript
-{}
-```
-
-#### `realtime:error`
-
-Error occurred during Realtime session.
-
-**Payload:**
-```typescript
-{ error: Error }
-```
-
-## Architecture
-
-The Realtime Manager follows Charivo's **Manager Pattern**:
-
-- **Stateful Manager** (`RealtimeManager`) - Manages session lifecycle and events
-- **Stateless Client** (e.g., `OpenAIRealtimeClient`) - Handles WebRTC/WebSocket connection
-
-```
-┌─────────────────────┐
-│  RealtimeManager    │  ←─ Stateful (session, events)
-└──────────┬──────────┘
-           ▼
-┌─────────────────────┐
-│  RealtimeClient     │  ←─ Stateless (WebRTC/WS)
-└─────────────────────┘
-```
-
-### Why This Design?
-
-- **Separation of Concerns**: Manager handles state, client handles protocol
-- **Testability**: Easy to mock clients for testing
-- **Flexibility**: Swap clients without changing app code
-- **Reusability**: Same client can be used in different contexts
+## Exports
 
-## Related Packages
+- `createRealtimeManager(client)`
+- `getEmotionSessionConfig(overrides?)`
+- `setEmotionTool`
+- `DEFAULT_EMOTION_INSTRUCTIONS`
+- realtime-related types re-exported from `@charivo/core`
 
-- [@charivo/realtime-client-openai](../realtime-client-openai) - OpenAI Realtime API client with WebRTC
-- [@charivo/core](../core) - Core types and interfaces
+## Event Bridge
 
-## License
+When connected to the Charivo event bus, the manager relays:
 
-MIT
+- `realtime:text:delta`
+- `realtime:emotion`
+- `realtime:error`
+- `tts:lipsync:update`
+- `tts:audio:start`
+- `tts:audio:end`

package/dist/index.d.mts

@@ -1,27 +1,6 @@
-import { Emotion } from '@charivo/core';
+import { RealtimeSessionConfig, RealtimeManager, CharivoEventEmitter, RealtimeTool, Emotion } from '@charivo/core';
+export { CharivoEventEmitter, RealtimeManager, RealtimeSessionConfig, RealtimeTool } from '@charivo/core';
 
-/**
- * Realtime API Types
- */
-interface RealtimeTool {
-    type: "function";
-    name: string;
-    description: string;
-    parameters: {
-        type: "object";
-        properties: Record<string, any>;
-        required?: string[];
-    };
-}
-interface RealtimeSessionConfig {
-    voice?: string;
-    model?: string;
-    instructions?: string;
-    temperature?: number;
-    maxTokens?: number;
-    tools?: RealtimeTool[];
-    tool_choice?: "auto" | "none" | "required";
-}
 interface RealtimeClient {
     connect(config?: RealtimeSessionConfig): Promise<void>;
     disconnect(): Promise<void>;
@@ -31,18 +10,9 @@ interface RealtimeClient {
     onAudioDelta(callback: (base64Audio: string) => void): void;
     onLipSyncUpdate?(callback: (rms: number) => void): void;
     onAudioDone(callback: () => void): void;
-    onToolCall?(callback: (name: string, args: any) => void): void;
+    onToolCall?(callback: (name: string, args: Record<string, unknown>) => void): void;
     onError(callback: (error: Error) => void): void;
 }
-interface RealtimeManager {
-    startSession(config: RealtimeSessionConfig): Promise<void>;
-    stopSession(): Promise<void>;
-    sendMessage(text: string): Promise<void>;
-    sendAudioChunk(audio: ArrayBuffer): Promise<void>;
-    setEventEmitter(eventEmitter: {
-        emit: (event: string, data: any) => void;
-    }): void;
-}
 
 /**
  * Realtime Manager - Realtime API 세션 관리
@@ -64,9 +34,7 @@ declare class RealtimeManagerImpl implements RealtimeManager {
     /**
      * 이벤트 발신자 설정
      */
-    setEventEmitter(eventEmitter: {
-        emit: (event: string, data: any) => void;
-    }): void;
+    setEventEmitter(eventEmitter: CharivoEventEmitter): void;
     /**
      * Realtime 세션 시작
      */
@@ -131,4 +99,4 @@ declare function getEmotionSessionConfig(overrides?: RealtimeSessionConfig): {
     tool_choice: "auto" | "none" | "required";
 };
 
-export { DEFAULT_EMOTION_INSTRUCTIONS, type EmotionArgs, type RealtimeClient, type RealtimeManager, RealtimeManagerImpl, type RealtimeSessionConfig, type RealtimeTool, createRealtimeManager, getEmotionSessionConfig, setEmotionTool };
+export { DEFAULT_EMOTION_INSTRUCTIONS, type EmotionArgs, type RealtimeClient, RealtimeManagerImpl, createRealtimeManager, getEmotionSessionConfig, setEmotionTool };

package/dist/index.d.ts

@@ -1,27 +1,6 @@
-import { Emotion } from '@charivo/core';
+import { RealtimeSessionConfig, RealtimeManager, CharivoEventEmitter, RealtimeTool, Emotion } from '@charivo/core';
+export { CharivoEventEmitter, RealtimeManager, RealtimeSessionConfig, RealtimeTool } from '@charivo/core';
 
-/**
- * Realtime API Types
- */
-interface RealtimeTool {
-    type: "function";
-    name: string;
-    description: string;
-    parameters: {
-        type: "object";
-        properties: Record<string, any>;
-        required?: string[];
-    };
-}
-interface RealtimeSessionConfig {
-    voice?: string;
-    model?: string;
-    instructions?: string;
-    temperature?: number;
-    maxTokens?: number;
-    tools?: RealtimeTool[];
-    tool_choice?: "auto" | "none" | "required";
-}
 interface RealtimeClient {
     connect(config?: RealtimeSessionConfig): Promise<void>;
     disconnect(): Promise<void>;
@@ -31,18 +10,9 @@ interface RealtimeClient {
     onAudioDelta(callback: (base64Audio: string) => void): void;
     onLipSyncUpdate?(callback: (rms: number) => void): void;
     onAudioDone(callback: () => void): void;
-    onToolCall?(callback: (name: string, args: any) => void): void;
+    onToolCall?(callback: (name: string, args: Record<string, unknown>) => void): void;
     onError(callback: (error: Error) => void): void;
 }
-interface RealtimeManager {
-    startSession(config: RealtimeSessionConfig): Promise<void>;
-    stopSession(): Promise<void>;
-    sendMessage(text: string): Promise<void>;
-    sendAudioChunk(audio: ArrayBuffer): Promise<void>;
-    setEventEmitter(eventEmitter: {
-        emit: (event: string, data: any) => void;
-    }): void;
-}
 
 /**
  * Realtime Manager - Realtime API 세션 관리
@@ -64,9 +34,7 @@ declare class RealtimeManagerImpl implements RealtimeManager {
     /**
      * 이벤트 발신자 설정
      */
-    setEventEmitter(eventEmitter: {
-        emit: (event: string, data: any) => void;
-    }): void;
+    setEventEmitter(eventEmitter: CharivoEventEmitter): void;
     /**
      * Realtime 세션 시작
      */
@@ -131,4 +99,4 @@ declare function getEmotionSessionConfig(overrides?: RealtimeSessionConfig): {
     tool_choice: "auto" | "none" | "required";
 };
 
-export { DEFAULT_EMOTION_INSTRUCTIONS, type EmotionArgs, type RealtimeClient, type RealtimeManager, RealtimeManagerImpl, type RealtimeSessionConfig, type RealtimeTool, createRealtimeManager, getEmotionSessionConfig, setEmotionTool };
+export { DEFAULT_EMOTION_INSTRUCTIONS, type EmotionArgs, type RealtimeClient, RealtimeManagerImpl, createRealtimeManager, getEmotionSessionConfig, setEmotionTool };

package/dist/index.js

@@ -17,7 +17,6 @@ var RealtimeManagerImpl = class {
    */
   setEventEmitter(eventEmitter) {
     this.eventEmitter = eventEmitter;
-    console.log("\u{1F517} Realtime Manager: Event emitter connected");
   }
   /**
    * Realtime 세션 시작
@@ -26,21 +25,17 @@ var RealtimeManagerImpl = class {
     if (this.isSessionActive) {
       throw new Error("Realtime session already active");
     }
-    console.log("\u{1F680} Starting Realtime session with config:", config);
     await this.client.connect(config);
     this.isSessionActive = true;
-    console.log("\u2705 Realtime session started");
   }
   /**
    * Realtime 세션 종료
    */
   async stopSession() {
     if (!this.isSessionActive) return;
-    console.log("\u{1F6D1} Stopping Realtime session");
     await this.client.disconnect();
     this.emitAudioEnd();
     this.isSessionActive = false;
-    console.log("\u2705 Realtime session stopped");
   }
   /**
    * 텍스트 메시지 전송
@@ -90,7 +85,6 @@ var RealtimeManagerImpl = class {
       });
     }
     this.client.onError((error) => {
-      console.error("Realtime client error:", error);
       this.emitAudioEnd();
       this.eventEmitter?.emit("realtime:error", { error });
     });
@@ -99,10 +93,10 @@ var RealtimeManagerImpl = class {
    * Tool call 처리
    */
   handleToolCall(name, args) {
-    if (name === "setEmotion") {
-      console.log(`\u{1F3AD} [Realtime] Emotion update:`, args.emotion);
+    const emotion = args.emotion;
+    if (name === "setEmotion" && typeof emotion === "string") {
       this.eventEmitter?.emit("realtime:emotion", {
-        emotion: args.emotion
+        emotion
       });
     }
   }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/realtime-manager.ts","../src/tools.ts"],"names":["Emotion"],"mappings":"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","file":"index.js","sourcesContent":["import {\n  RealtimeClient,\n  RealtimeManager as IRealtimeManager,\n  RealtimeSessionConfig,\n} from \"./types\";\n\n/**\n * Realtime Manager - Realtime API 세션 관리\n *\n * 역할:\n * - Realtime 클라이언트 관리 (WebRTC)\n * - 립싱크 이벤트 중계\n * - 텍스트 스트리밍 처리\n *\n * Note: WebRTC 클라이언트는 오디오를 자동으로 처리하므로\n * 이 Manager는 이벤트 중계에 집중합니다.\n */\nexport class RealtimeManagerImpl implements IRealtimeManager {\n  private client: RealtimeClient;\n  private eventEmitter?: { emit: (event: string, data: any) => void };\n  private isSessionActive = false;\n  private isAudioPlaybackActive = false;\n\n  constructor(client: RealtimeClient) {\n    this.client = client;\n    this.setupClientListeners();\n  }\n\n  /**\n   * 이벤트 발신자 설정\n   */\n  setEventEmitter(eventEmitter: {\n    emit: (event: string, data: any) => void;\n  }): void {\n    this.eventEmitter = eventEmitter;\n    console.log(\"🔗 Realtime Manager: Event emitter connected\");\n  }\n\n  /**\n   * Realtime 세션 시작\n   */\n  async startSession(config: RealtimeSessionConfig): Promise<void> {\n    if (this.isSessionActive) {\n      throw new Error(\"Realtime session already active\");\n    }\n\n    console.log(\"🚀 Starting Realtime session with config:\", config);\n\n    // 클라이언트 연결\n    await this.client.connect(config);\n\n    this.isSessionActive = true;\n\n    console.log(\"✅ Realtime session started\");\n  }\n\n  /**\n   * Realtime 세션 종료\n   */\n  async stopSession(): Promise<void> {\n    if (!this.isSessionActive) return;\n\n    console.log(\"🛑 Stopping Realtime session\");\n\n    // 클라이언트 연결 해제\n    await this.client.disconnect();\n    this.emitAudioEnd();\n\n    this.isSessionActive = false;\n\n    console.log(\"✅ Realtime session stopped\");\n  }\n\n  /**\n   * 텍스트 메시지 전송\n   */\n  async sendMessage(text: string): Promise<void> {\n    if (!this.isSessionActive) {\n      throw new Error(\"Realtime session not active\");\n    }\n\n    this.emitAudioStart();\n    try {\n      await this.client.sendText(text);\n    } catch (error) {\n      this.emitAudioEnd();\n      throw error;\n    }\n  }\n\n  /**\n   * 오디오 청크 전송 (사용자 음성)\n   */\n  async sendAudioChunk(audio: ArrayBuffer): Promise<void> {\n    if (!this.isSessionActive) {\n      throw new Error(\"Realtime session not active\");\n    }\n\n    await this.client.sendAudio(audio);\n  }\n\n  /**\n   * 클라이언트 이벤트 리스너 설정\n   */\n  private setupClientListeners(): void {\n    // 텍스트 스트리밍\n    this.client.onTextDelta((text: string) => {\n      this.eventEmitter?.emit(\"realtime:text:delta\", { text });\n    });\n\n    // Direct RMS callback (for WebRTC clients)\n    if (this.client.onLipSyncUpdate) {\n      this.client.onLipSyncUpdate((rms: number) => {\n        if (rms > 0.001 && !this.isAudioPlaybackActive) {\n          this.emitAudioStart();\n        }\n        this.eventEmitter?.emit(\"tts:lipsync:update\", { rms });\n      });\n    }\n\n    // 오디오 스트리밍 종료\n    this.client.onAudioDone(() => {\n      this.emitAudioEnd();\n    });\n\n    // Tool call 처리\n    if (this.client.onToolCall) {\n      this.client.onToolCall((name: string, args: any) => {\n        this.handleToolCall(name, args);\n      });\n    }\n\n    // 에러 처리\n    this.client.onError((error: Error) => {\n      console.error(\"Realtime client error:\", error);\n      this.emitAudioEnd();\n      this.eventEmitter?.emit(\"realtime:error\", { error });\n    });\n  }\n\n  /**\n   * Tool call 처리\n   */\n  private handleToolCall(name: string, args: any): void {\n    if (name === \"setEmotion\") {\n      console.log(`🎭 [Realtime] Emotion update:`, args.emotion);\n      // Emit emotion event for RenderManager\n      this.eventEmitter?.emit(\"realtime:emotion\", {\n        emotion: args.emotion,\n      });\n    }\n  }\n\n  private emitAudioStart(): void {\n    if (this.isAudioPlaybackActive) {\n      return;\n    }\n    this.isAudioPlaybackActive = true;\n    this.eventEmitter?.emit(\"tts:audio:start\", {});\n  }\n\n  private emitAudioEnd(): void {\n    if (!this.isAudioPlaybackActive) {\n      return;\n    }\n    this.isAudioPlaybackActive = false;\n    this.eventEmitter?.emit(\"tts:lipsync:update\", { rms: 0 });\n    this.eventEmitter?.emit(\"tts:audio:end\", {});\n  }\n}\n\n/**\n * Realtime Manager 생성 헬퍼 함수\n */\nexport function createRealtimeManager(\n  client: RealtimeClient,\n): IRealtimeManager {\n  return new RealtimeManagerImpl(client);\n}\n","import type { RealtimeSessionConfig, RealtimeTool } from \"./types\";\nimport { Emotion } from \"@charivo/core\";\n\n/**\n * Get emotion enum values for tool definition\n */\nconst EMOTION_VALUES = Object.values(Emotion);\n\n/**\n * setEmotion tool definition for OpenAI Realtime API\n *\n * This tool allows the LLM to update the Live2D character's emotion.\n */\nexport const setEmotionTool: RealtimeTool = {\n  type: \"function\",\n  name: \"setEmotion\",\n  description:\n    \"Update Live2D character emotion. Call this when the conversation mood or emotion changes.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      emotion: {\n        type: \"string\",\n        description: \"Emotion of the character.\",\n        enum: EMOTION_VALUES,\n      },\n    },\n    required: [\"emotion\"],\n  },\n};\n\n/**\n * Emotion tool call arguments type\n */\nexport interface EmotionArgs {\n  emotion: Emotion;\n}\n\n/**\n * Default instructions for character with emotion support\n */\nexport const DEFAULT_EMOTION_INSTRUCTIONS = `\nYou are a Live2D character with emotions and expressions.\nRespond naturally to the user's messages.\nWhen the conversation mood or emotion changes, call the 'setEmotion' tool to update your expression and motion.\nDo NOT mention the tool call in your response - just respond naturally and let the emotion show through your character.\n`.trim();\n\n/**\n * Get default Realtime session config with emotion support\n */\nexport function getEmotionSessionConfig(overrides?: RealtimeSessionConfig): {\n  type: string;\n  model: string;\n  audio: { output: { voice: string } };\n  instructions: string;\n  tools: RealtimeTool[];\n  tool_choice: \"auto\" | \"none\" | \"required\";\n} {\n  const toolsFromConfig = overrides?.tools ?? [];\n  const hasEmotionTool = toolsFromConfig.some(\n    (tool) => tool.type === \"function\" && tool.name === setEmotionTool.name,\n  );\n  const tools = hasEmotionTool\n    ? toolsFromConfig\n    : [setEmotionTool, ...toolsFromConfig];\n\n  return {\n    type: \"realtime\",\n    model: overrides?.model || \"gpt-realtime-mini\",\n    audio: {\n      output: {\n        voice: overrides?.voice || \"marin\",\n      },\n    },\n    instructions: overrides?.instructions || DEFAULT_EMOTION_INSTRUCTIONS,\n    tools,\n    tool_choice: overrides?.tool_choice ?? \"auto\",\n  };\n}\n"]}
+{"version":3,"sources":["../src/realtime-manager.ts","../src/tools.ts"],"names":["Emotion"],"mappings":";;;;;AAmBO,IAAM,sBAAN,MAAyD;AAAA,EACtD,MAAA;AAAA,EACA,YAAA;AAAA,EACA,eAAA,GAAkB,KAAA;AAAA,EAClB,qBAAA,GAAwB,KAAA;AAAA,EAEhC,YAAY,MAAA,EAAwB;AAClC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,oBAAA,EAAqB;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAgB,YAAA,EAAyC;AACvD,IAAA,IAAA,CAAK,YAAA,GAAe,YAAA;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAAa,MAAA,EAA8C;AAC/D,IAAA,IAAI,KAAK,eAAA,EAAiB;AACxB,MAAA,MAAM,IAAI,MAAM,iCAAiC,CAAA;AAAA,IACnD;AAGA,IAAA,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA;AAEhC,IAAA,IAAA,CAAK,eAAA,GAAkB,IAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,WAAA,GAA6B;AACjC,IAAA,IAAI,CAAC,KAAK,eAAA,EAAiB;AAG3B,IAAA,MAAM,IAAA,CAAK,OAAO,UAAA,EAAW;AAC7B,IAAA,IAAA,CAAK,YAAA,EAAa;AAElB,IAAA,IAAA,CAAK,eAAA,GAAkB,KAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,YAAY,IAAA,EAA6B;AAC7C,IAAA,IAAI,CAAC,KAAK,eAAA,EAAiB;AACzB,MAAA,MAAM,IAAI,MAAM,6BAA6B,CAAA;AAAA,IAC/C;AAEA,IAAA,IAAA,CAAK,cAAA,EAAe;AACpB,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,CAAK,MAAA,CAAO,QAAA,CAAS,IAAI,CAAA;AAAA,IACjC,SAAS,KAAA,EAAO;AACd,MAAA,IAAA,CAAK,YAAA,EAAa;AAClB,MAAA,MAAM,KAAA;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe,KAAA,EAAmC;AACtD,IAAA,IAAI,CAAC,KAAK,eAAA,EAAiB;AACzB,MAAA,MAAM,IAAI,MAAM,6BAA6B,CAAA;AAAA,IAC/C;AAEA,IAAA,MAAM,IAAA,CAAK,MAAA,CAAO,SAAA,CAAU,KAAK,CAAA;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA,EAKQ,oBAAA,GAA6B;AAEnC,IAAA,IAAA,CAAK,MAAA,CAAO,WAAA,CAAY,CAAC,IAAA,KAAiB;AACxC,MAAA,IAAA,CAAK,YAAA,EAAc,IAAA,CAAK,qBAAA,EAAuB,EAAE,MAAM,CAAA;AAAA,IACzD,CAAC,CAAA;AAGD,IAAA,IAAI,IAAA,CAAK,OAAO,eAAA,EAAiB;AAC/B,MAAA,IAAA,CAAK,MAAA,CAAO,eAAA,CAAgB,CAAC,GAAA,KAAgB;AAC3C,QAAA,IAAI,GAAA,GAAM,IAAA,IAAS,CAAC,IAAA,CAAK,qBAAA,EAAuB;AAC9C,UAAA,IAAA,CAAK,cAAA,EAAe;AAAA,QACtB;AACA,QAAA,IAAA,CAAK,YAAA,EAAc,IAAA,CAAK,oBAAA,EAAsB,EAAE,KAAK,CAAA;AAAA,MACvD,CAAC,CAAA;AAAA,IACH;AAGA,IAAA,IAAA,CAAK,MAAA,CAAO,YAAY,MAAM;AAC5B,MAAA,IAAA,CAAK,YAAA,EAAa;AAAA,IACpB,CAAC,CAAA;AAGD,IAAA,IAAI,IAAA,CAAK,OAAO,UAAA,EAAY;AAC1B,MAAA,IAAA,CAAK,MAAA,CAAO,UAAA,CAAW,CAAC,IAAA,EAAc,IAAA,KAAkC;AACtE,QAAA,IAAA,CAAK,cAAA,CAAe,MAAM,IAAI,CAAA;AAAA,MAChC,CAAC,CAAA;AAAA,IACH;AAGA,IAAA,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,CAAC,KAAA,KAAiB;AACpC,MAAA,IAAA,CAAK,YAAA,EAAa;AAClB,MAAA,IAAA,CAAK,YAAA,EAAc,IAAA,CAAK,gBAAA,EAAkB,EAAE,OAAO,CAAA;AAAA,IACrD,CAAC,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKQ,cAAA,CAAe,MAAc,IAAA,EAAqC;AACxE,IAAA,MAAM,UAAU,IAAA,CAAK,OAAA;AAErB,IAAA,IAAI,IAAA,KAAS,YAAA,IAAgB,OAAO,OAAA,KAAY,QAAA,EAAU;AACxD,MAAA,IAAA,CAAK,YAAA,EAAc,KAAK,kBAAA,EAAoB;AAAA,QAC1C;AAAA,OACD,CAAA;AAAA,IACH;AAAA,EACF;AAAA,EAEQ,cAAA,GAAuB;AAC7B,IAAA,IAAI,KAAK,qBAAA,EAAuB;AAC9B,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,qBAAA,GAAwB,IAAA;AAC7B,IAAA,IAAA,CAAK,YAAA,EAAc,IAAA,CAAK,iBAAA,EAAmB,EAAE,CAAA;AAAA,EAC/C;AAAA,EAEQ,YAAA,GAAqB;AAC3B,IAAA,IAAI,CAAC,KAAK,qBAAA,EAAuB;AAC/B,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,qBAAA,GAAwB,KAAA;AAC7B,IAAA,IAAA,CAAK,cAAc,IAAA,CAAK,oBAAA,EAAsB,EAAE,GAAA,EAAK,GAAG,CAAA;AACxD,IAAA,IAAA,CAAK,YAAA,EAAc,IAAA,CAAK,eAAA,EAAiB,EAAE,CAAA;AAAA,EAC7C;AACF;AAKO,SAAS,sBACd,MAAA,EACqB;AACrB,EAAA,OAAO,IAAI,oBAAoB,MAAM,CAAA;AACvC;AC/JA,IAAM,cAAA,GAAiB,MAAA,CAAO,MAAA,CAAOA,YAAO,CAAA;AAOrC,IAAM,cAAA,GAA+B;AAAA,EAC1C,IAAA,EAAM,UAAA;AAAA,EACN,IAAA,EAAM,YAAA;AAAA,EACN,WAAA,EACE,2FAAA;AAAA,EACF,UAAA,EAAY;AAAA,IACV,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,OAAA,EAAS;AAAA,QACP,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa,2BAAA;AAAA,QACb,IAAA,EAAM;AAAA;AACR,KACF;AAAA,IACA,QAAA,EAAU,CAAC,SAAS;AAAA;AAExB;AAYO,IAAM,4BAAA,GAA+B;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA,CAK1C,IAAA;AAKK,SAAS,wBAAwB,SAAA,EAOtC;AACA,EAAA,MAAM,eAAA,GAAkB,SAAA,EAAW,KAAA,IAAS,EAAC;AAC7C,EAAA,MAAM,iBAAiB,eAAA,CAAgB,IAAA;AAAA,IACrC,CAAC,IAAA,KAAS,IAAA,CAAK,SAAS,UAAA,IAAc,IAAA,CAAK,SAAS,cAAA,CAAe;AAAA,GACrE;AACA,EAAA,MAAM,QAAQ,cAAA,GACV,eAAA,GACA,CAAC,cAAA,EAAgB,GAAG,eAAe,CAAA;AAEvC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,UAAA;AAAA,IACN,KAAA,EAAO,WAAW,KAAA,IAAS,mBAAA;AAAA,IAC3B,KAAA,EAAO;AAAA,MACL,MAAA,EAAQ;AAAA,QACN,KAAA,EAAO,WAAW,KAAA,IAAS;AAAA;AAC7B,KACF;AAAA,IACA,YAAA,EAAc,WAAW,YAAA,IAAgB,4BAAA;AAAA,IACzC,KAAA;AAAA,IACA,WAAA,EAAa,WAAW,WAAA,IAAe;AAAA,GACzC;AACF","file":"index.js","sourcesContent":["import {\n  CharivoEventEmitter,\n  RealtimeManager as CoreRealtimeManager,\n  RealtimeSessionConfig,\n  RealtimeClient,\n} from \"./types\";\nimport { Emotion } from \"@charivo/core\";\n\n/**\n * Realtime Manager - Realtime API 세션 관리\n *\n * 역할:\n * - Realtime 클라이언트 관리 (WebRTC)\n * - 립싱크 이벤트 중계\n * - 텍스트 스트리밍 처리\n *\n * Note: WebRTC 클라이언트는 오디오를 자동으로 처리하므로\n * 이 Manager는 이벤트 중계에 집중합니다.\n */\nexport class RealtimeManagerImpl implements CoreRealtimeManager {\n  private client: RealtimeClient;\n  private eventEmitter?: CharivoEventEmitter;\n  private isSessionActive = false;\n  private isAudioPlaybackActive = false;\n\n  constructor(client: RealtimeClient) {\n    this.client = client;\n    this.setupClientListeners();\n  }\n\n  /**\n   * 이벤트 발신자 설정\n   */\n  setEventEmitter(eventEmitter: CharivoEventEmitter): void {\n    this.eventEmitter = eventEmitter;\n  }\n\n  /**\n   * Realtime 세션 시작\n   */\n  async startSession(config: RealtimeSessionConfig): Promise<void> {\n    if (this.isSessionActive) {\n      throw new Error(\"Realtime session already active\");\n    }\n\n    // 클라이언트 연결\n    await this.client.connect(config);\n\n    this.isSessionActive = true;\n  }\n\n  /**\n   * Realtime 세션 종료\n   */\n  async stopSession(): Promise<void> {\n    if (!this.isSessionActive) return;\n\n    // 클라이언트 연결 해제\n    await this.client.disconnect();\n    this.emitAudioEnd();\n\n    this.isSessionActive = false;\n  }\n\n  /**\n   * 텍스트 메시지 전송\n   */\n  async sendMessage(text: string): Promise<void> {\n    if (!this.isSessionActive) {\n      throw new Error(\"Realtime session not active\");\n    }\n\n    this.emitAudioStart();\n    try {\n      await this.client.sendText(text);\n    } catch (error) {\n      this.emitAudioEnd();\n      throw error;\n    }\n  }\n\n  /**\n   * 오디오 청크 전송 (사용자 음성)\n   */\n  async sendAudioChunk(audio: ArrayBuffer): Promise<void> {\n    if (!this.isSessionActive) {\n      throw new Error(\"Realtime session not active\");\n    }\n\n    await this.client.sendAudio(audio);\n  }\n\n  /**\n   * 클라이언트 이벤트 리스너 설정\n   */\n  private setupClientListeners(): void {\n    // 텍스트 스트리밍\n    this.client.onTextDelta((text: string) => {\n      this.eventEmitter?.emit(\"realtime:text:delta\", { text });\n    });\n\n    // Direct RMS callback (for WebRTC clients)\n    if (this.client.onLipSyncUpdate) {\n      this.client.onLipSyncUpdate((rms: number) => {\n        if (rms > 0.001 && !this.isAudioPlaybackActive) {\n          this.emitAudioStart();\n        }\n        this.eventEmitter?.emit(\"tts:lipsync:update\", { rms });\n      });\n    }\n\n    // 오디오 스트리밍 종료\n    this.client.onAudioDone(() => {\n      this.emitAudioEnd();\n    });\n\n    // Tool call 처리\n    if (this.client.onToolCall) {\n      this.client.onToolCall((name: string, args: Record<string, unknown>) => {\n        this.handleToolCall(name, args);\n      });\n    }\n\n    // 에러 처리\n    this.client.onError((error: Error) => {\n      this.emitAudioEnd();\n      this.eventEmitter?.emit(\"realtime:error\", { error });\n    });\n  }\n\n  /**\n   * Tool call 처리\n   */\n  private handleToolCall(name: string, args: Record<string, unknown>): void {\n    const emotion = args.emotion;\n\n    if (name === \"setEmotion\" && typeof emotion === \"string\") {\n      this.eventEmitter?.emit(\"realtime:emotion\", {\n        emotion: emotion as Emotion,\n      });\n    }\n  }\n\n  private emitAudioStart(): void {\n    if (this.isAudioPlaybackActive) {\n      return;\n    }\n    this.isAudioPlaybackActive = true;\n    this.eventEmitter?.emit(\"tts:audio:start\", {});\n  }\n\n  private emitAudioEnd(): void {\n    if (!this.isAudioPlaybackActive) {\n      return;\n    }\n    this.isAudioPlaybackActive = false;\n    this.eventEmitter?.emit(\"tts:lipsync:update\", { rms: 0 });\n    this.eventEmitter?.emit(\"tts:audio:end\", {});\n  }\n}\n\n/**\n * Realtime Manager 생성 헬퍼 함수\n */\nexport function createRealtimeManager(\n  client: RealtimeClient,\n): CoreRealtimeManager {\n  return new RealtimeManagerImpl(client);\n}\n","import {\n  Emotion,\n  type RealtimeSessionConfig,\n  type RealtimeTool,\n} from \"@charivo/core\";\n\n/**\n * Get emotion enum values for tool definition\n */\nconst EMOTION_VALUES = Object.values(Emotion);\n\n/**\n * setEmotion tool definition for OpenAI Realtime API\n *\n * This tool allows the LLM to update the Live2D character's emotion.\n */\nexport const setEmotionTool: RealtimeTool = {\n  type: \"function\",\n  name: \"setEmotion\",\n  description:\n    \"Update Live2D character emotion. Call this when the conversation mood or emotion changes.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      emotion: {\n        type: \"string\",\n        description: \"Emotion of the character.\",\n        enum: EMOTION_VALUES,\n      },\n    },\n    required: [\"emotion\"],\n  },\n};\n\n/**\n * Emotion tool call arguments type\n */\nexport interface EmotionArgs {\n  emotion: Emotion;\n}\n\n/**\n * Default instructions for character with emotion support\n */\nexport const DEFAULT_EMOTION_INSTRUCTIONS = `\nYou are a Live2D character with emotions and expressions.\nRespond naturally to the user's messages.\nWhen the conversation mood or emotion changes, call the 'setEmotion' tool to update your expression and motion.\nDo NOT mention the tool call in your response - just respond naturally and let the emotion show through your character.\n`.trim();\n\n/**\n * Get default Realtime session config with emotion support\n */\nexport function getEmotionSessionConfig(overrides?: RealtimeSessionConfig): {\n  type: string;\n  model: string;\n  audio: { output: { voice: string } };\n  instructions: string;\n  tools: RealtimeTool[];\n  tool_choice: \"auto\" | \"none\" | \"required\";\n} {\n  const toolsFromConfig = overrides?.tools ?? [];\n  const hasEmotionTool = toolsFromConfig.some(\n    (tool) => tool.type === \"function\" && tool.name === setEmotionTool.name,\n  );\n  const tools = hasEmotionTool\n    ? toolsFromConfig\n    : [setEmotionTool, ...toolsFromConfig];\n\n  return {\n    type: \"realtime\",\n    model: overrides?.model || \"gpt-realtime-mini\",\n    audio: {\n      output: {\n        voice: overrides?.voice || \"marin\",\n      },\n    },\n    instructions: overrides?.instructions || DEFAULT_EMOTION_INSTRUCTIONS,\n    tools,\n    tool_choice: overrides?.tool_choice ?? \"auto\",\n  };\n}\n"]}

package/dist/index.mjs

@@ -15,7 +15,6 @@ var RealtimeManagerImpl = class {
    */
   setEventEmitter(eventEmitter) {
     this.eventEmitter = eventEmitter;
-    console.log("\u{1F517} Realtime Manager: Event emitter connected");
   }
   /**
    * Realtime 세션 시작
@@ -24,21 +23,17 @@ var RealtimeManagerImpl = class {
     if (this.isSessionActive) {
       throw new Error("Realtime session already active");
     }
-    console.log("\u{1F680} Starting Realtime session with config:", config);
     await this.client.connect(config);
     this.isSessionActive = true;
-    console.log("\u2705 Realtime session started");
   }
   /**
    * Realtime 세션 종료
    */
   async stopSession() {
     if (!this.isSessionActive) return;
-    console.log("\u{1F6D1} Stopping Realtime session");
     await this.client.disconnect();
     this.emitAudioEnd();
     this.isSessionActive = false;
-    console.log("\u2705 Realtime session stopped");
   }
   /**
    * 텍스트 메시지 전송
@@ -88,7 +83,6 @@ var RealtimeManagerImpl = class {
       });
     }
     this.client.onError((error) => {
-      console.error("Realtime client error:", error);
       this.emitAudioEnd();
       this.eventEmitter?.emit("realtime:error", { error });
     });
@@ -97,10 +91,10 @@ var RealtimeManagerImpl = class {
    * Tool call 처리
    */
   handleToolCall(name, args) {
-    if (name === "setEmotion") {
-      console.log(`\u{1F3AD} [Realtime] Emotion update:`, args.emotion);
+    const emotion = args.emotion;
+    if (name === "setEmotion" && typeof emotion === "string") {
       this.eventEmitter?.emit("realtime:emotion", {
-        emotion: args.emotion
+        emotion
       });
     }
   }

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/realtime-manager.ts","../src/tools.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import {\n  RealtimeClient,\n  RealtimeManager as IRealtimeManager,\n  RealtimeSessionConfig,\n} from \"./types\";\n\n/**\n * Realtime Manager - Realtime API 세션 관리\n *\n * 역할:\n * - Realtime 클라이언트 관리 (WebRTC)\n * - 립싱크 이벤트 중계\n * - 텍스트 스트리밍 처리\n *\n * Note: WebRTC 클라이언트는 오디오를 자동으로 처리하므로\n * 이 Manager는 이벤트 중계에 집중합니다.\n */\nexport class RealtimeManagerImpl implements IRealtimeManager {\n  private client: RealtimeClient;\n  private eventEmitter?: { emit: (event: string, data: any) => void };\n  private isSessionActive = false;\n  private isAudioPlaybackActive = false;\n\n  constructor(client: RealtimeClient) {\n    this.client = client;\n    this.setupClientListeners();\n  }\n\n  /**\n   * 이벤트 발신자 설정\n   */\n  setEventEmitter(eventEmitter: {\n    emit: (event: string, data: any) => void;\n  }): void {\n    this.eventEmitter = eventEmitter;\n    console.log(\"🔗 Realtime Manager: Event emitter connected\");\n  }\n\n  /**\n   * Realtime 세션 시작\n   */\n  async startSession(config: RealtimeSessionConfig): Promise<void> {\n    if (this.isSessionActive) {\n      throw new Error(\"Realtime session already active\");\n    }\n\n    console.log(\"🚀 Starting Realtime session with config:\", config);\n\n    // 클라이언트 연결\n    await this.client.connect(config);\n\n    this.isSessionActive = true;\n\n    console.log(\"✅ Realtime session started\");\n  }\n\n  /**\n   * Realtime 세션 종료\n   */\n  async stopSession(): Promise<void> {\n    if (!this.isSessionActive) return;\n\n    console.log(\"🛑 Stopping Realtime session\");\n\n    // 클라이언트 연결 해제\n    await this.client.disconnect();\n    this.emitAudioEnd();\n\n    this.isSessionActive = false;\n\n    console.log(\"✅ Realtime session stopped\");\n  }\n\n  /**\n   * 텍스트 메시지 전송\n   */\n  async sendMessage(text: string): Promise<void> {\n    if (!this.isSessionActive) {\n      throw new Error(\"Realtime session not active\");\n    }\n\n    this.emitAudioStart();\n    try {\n      await this.client.sendText(text);\n    } catch (error) {\n      this.emitAudioEnd();\n      throw error;\n    }\n  }\n\n  /**\n   * 오디오 청크 전송 (사용자 음성)\n   */\n  async sendAudioChunk(audio: ArrayBuffer): Promise<void> {\n    if (!this.isSessionActive) {\n      throw new Error(\"Realtime session not active\");\n    }\n\n    await this.client.sendAudio(audio);\n  }\n\n  /**\n   * 클라이언트 이벤트 리스너 설정\n   */\n  private setupClientListeners(): void {\n    // 텍스트 스트리밍\n    this.client.onTextDelta((text: string) => {\n      this.eventEmitter?.emit(\"realtime:text:delta\", { text });\n    });\n\n    // Direct RMS callback (for WebRTC clients)\n    if (this.client.onLipSyncUpdate) {\n      this.client.onLipSyncUpdate((rms: number) => {\n        if (rms > 0.001 && !this.isAudioPlaybackActive) {\n          this.emitAudioStart();\n        }\n        this.eventEmitter?.emit(\"tts:lipsync:update\", { rms });\n      });\n    }\n\n    // 오디오 스트리밍 종료\n    this.client.onAudioDone(() => {\n      this.emitAudioEnd();\n    });\n\n    // Tool call 처리\n    if (this.client.onToolCall) {\n      this.client.onToolCall((name: string, args: any) => {\n        this.handleToolCall(name, args);\n      });\n    }\n\n    // 에러 처리\n    this.client.onError((error: Error) => {\n      console.error(\"Realtime client error:\", error);\n      this.emitAudioEnd();\n      this.eventEmitter?.emit(\"realtime:error\", { error });\n    });\n  }\n\n  /**\n   * Tool call 처리\n   */\n  private handleToolCall(name: string, args: any): void {\n    if (name === \"setEmotion\") {\n      console.log(`🎭 [Realtime] Emotion update:`, args.emotion);\n      // Emit emotion event for RenderManager\n      this.eventEmitter?.emit(\"realtime:emotion\", {\n        emotion: args.emotion,\n      });\n    }\n  }\n\n  private emitAudioStart(): void {\n    if (this.isAudioPlaybackActive) {\n      return;\n    }\n    this.isAudioPlaybackActive = true;\n    this.eventEmitter?.emit(\"tts:audio:start\", {});\n  }\n\n  private emitAudioEnd(): void {\n    if (!this.isAudioPlaybackActive) {\n      return;\n    }\n    this.isAudioPlaybackActive = false;\n    this.eventEmitter?.emit(\"tts:lipsync:update\", { rms: 0 });\n    this.eventEmitter?.emit(\"tts:audio:end\", {});\n  }\n}\n\n/**\n * Realtime Manager 생성 헬퍼 함수\n */\nexport function createRealtimeManager(\n  client: RealtimeClient,\n): IRealtimeManager {\n  return new RealtimeManagerImpl(client);\n}\n","import type { RealtimeSessionConfig, RealtimeTool } from \"./types\";\nimport { Emotion } from \"@charivo/core\";\n\n/**\n * Get emotion enum values for tool definition\n */\nconst EMOTION_VALUES = Object.values(Emotion);\n\n/**\n * setEmotion tool definition for OpenAI Realtime API\n *\n * This tool allows the LLM to update the Live2D character's emotion.\n */\nexport const setEmotionTool: RealtimeTool = {\n  type: \"function\",\n  name: \"setEmotion\",\n  description:\n    \"Update Live2D character emotion. Call this when the conversation mood or emotion changes.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      emotion: {\n        type: \"string\",\n        description: \"Emotion of the character.\",\n        enum: EMOTION_VALUES,\n      },\n    },\n    required: [\"emotion\"],\n  },\n};\n\n/**\n * Emotion tool call arguments type\n */\nexport interface EmotionArgs {\n  emotion: Emotion;\n}\n\n/**\n * Default instructions for character with emotion support\n */\nexport const DEFAULT_EMOTION_INSTRUCTIONS = `\nYou are a Live2D character with emotions and expressions.\nRespond naturally to the user's messages.\nWhen the conversation mood or emotion changes, call the 'setEmotion' tool to update your expression and motion.\nDo NOT mention the tool call in your response - just respond naturally and let the emotion show through your character.\n`.trim();\n\n/**\n * Get default Realtime session config with emotion support\n */\nexport function getEmotionSessionConfig(overrides?: RealtimeSessionConfig): {\n  type: string;\n  model: string;\n  audio: { output: { voice: string } };\n  instructions: string;\n  tools: RealtimeTool[];\n  tool_choice: \"auto\" | \"none\" | \"required\";\n} {\n  const toolsFromConfig = overrides?.tools ?? [];\n  const hasEmotionTool = toolsFromConfig.some(\n    (tool) => tool.type === \"function\" && tool.name === setEmotionTool.name,\n  );\n  const tools = hasEmotionTool\n    ? toolsFromConfig\n    : [setEmotionTool, ...toolsFromConfig];\n\n  return {\n    type: \"realtime\",\n    model: overrides?.model || \"gpt-realtime-mini\",\n    audio: {\n      output: {\n        voice: overrides?.voice || \"marin\",\n      },\n    },\n    instructions: overrides?.instructions || DEFAULT_EMOTION_INSTRUCTIONS,\n    tools,\n    tool_choice: overrides?.tool_choice ?? \"auto\",\n  };\n}\n"]}
+{"version":3,"sources":["../src/realtime-manager.ts","../src/tools.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import {\n  CharivoEventEmitter,\n  RealtimeManager as CoreRealtimeManager,\n  RealtimeSessionConfig,\n  RealtimeClient,\n} from \"./types\";\nimport { Emotion } from \"@charivo/core\";\n\n/**\n * Realtime Manager - Realtime API 세션 관리\n *\n * 역할:\n * - Realtime 클라이언트 관리 (WebRTC)\n * - 립싱크 이벤트 중계\n * - 텍스트 스트리밍 처리\n *\n * Note: WebRTC 클라이언트는 오디오를 자동으로 처리하므로\n * 이 Manager는 이벤트 중계에 집중합니다.\n */\nexport class RealtimeManagerImpl implements CoreRealtimeManager {\n  private client: RealtimeClient;\n  private eventEmitter?: CharivoEventEmitter;\n  private isSessionActive = false;\n  private isAudioPlaybackActive = false;\n\n  constructor(client: RealtimeClient) {\n    this.client = client;\n    this.setupClientListeners();\n  }\n\n  /**\n   * 이벤트 발신자 설정\n   */\n  setEventEmitter(eventEmitter: CharivoEventEmitter): void {\n    this.eventEmitter = eventEmitter;\n  }\n\n  /**\n   * Realtime 세션 시작\n   */\n  async startSession(config: RealtimeSessionConfig): Promise<void> {\n    if (this.isSessionActive) {\n      throw new Error(\"Realtime session already active\");\n    }\n\n    // 클라이언트 연결\n    await this.client.connect(config);\n\n    this.isSessionActive = true;\n  }\n\n  /**\n   * Realtime 세션 종료\n   */\n  async stopSession(): Promise<void> {\n    if (!this.isSessionActive) return;\n\n    // 클라이언트 연결 해제\n    await this.client.disconnect();\n    this.emitAudioEnd();\n\n    this.isSessionActive = false;\n  }\n\n  /**\n   * 텍스트 메시지 전송\n   */\n  async sendMessage(text: string): Promise<void> {\n    if (!this.isSessionActive) {\n      throw new Error(\"Realtime session not active\");\n    }\n\n    this.emitAudioStart();\n    try {\n      await this.client.sendText(text);\n    } catch (error) {\n      this.emitAudioEnd();\n      throw error;\n    }\n  }\n\n  /**\n   * 오디오 청크 전송 (사용자 음성)\n   */\n  async sendAudioChunk(audio: ArrayBuffer): Promise<void> {\n    if (!this.isSessionActive) {\n      throw new Error(\"Realtime session not active\");\n    }\n\n    await this.client.sendAudio(audio);\n  }\n\n  /**\n   * 클라이언트 이벤트 리스너 설정\n   */\n  private setupClientListeners(): void {\n    // 텍스트 스트리밍\n    this.client.onTextDelta((text: string) => {\n      this.eventEmitter?.emit(\"realtime:text:delta\", { text });\n    });\n\n    // Direct RMS callback (for WebRTC clients)\n    if (this.client.onLipSyncUpdate) {\n      this.client.onLipSyncUpdate((rms: number) => {\n        if (rms > 0.001 && !this.isAudioPlaybackActive) {\n          this.emitAudioStart();\n        }\n        this.eventEmitter?.emit(\"tts:lipsync:update\", { rms });\n      });\n    }\n\n    // 오디오 스트리밍 종료\n    this.client.onAudioDone(() => {\n      this.emitAudioEnd();\n    });\n\n    // Tool call 처리\n    if (this.client.onToolCall) {\n      this.client.onToolCall((name: string, args: Record<string, unknown>) => {\n        this.handleToolCall(name, args);\n      });\n    }\n\n    // 에러 처리\n    this.client.onError((error: Error) => {\n      this.emitAudioEnd();\n      this.eventEmitter?.emit(\"realtime:error\", { error });\n    });\n  }\n\n  /**\n   * Tool call 처리\n   */\n  private handleToolCall(name: string, args: Record<string, unknown>): void {\n    const emotion = args.emotion;\n\n    if (name === \"setEmotion\" && typeof emotion === \"string\") {\n      this.eventEmitter?.emit(\"realtime:emotion\", {\n        emotion: emotion as Emotion,\n      });\n    }\n  }\n\n  private emitAudioStart(): void {\n    if (this.isAudioPlaybackActive) {\n      return;\n    }\n    this.isAudioPlaybackActive = true;\n    this.eventEmitter?.emit(\"tts:audio:start\", {});\n  }\n\n  private emitAudioEnd(): void {\n    if (!this.isAudioPlaybackActive) {\n      return;\n    }\n    this.isAudioPlaybackActive = false;\n    this.eventEmitter?.emit(\"tts:lipsync:update\", { rms: 0 });\n    this.eventEmitter?.emit(\"tts:audio:end\", {});\n  }\n}\n\n/**\n * Realtime Manager 생성 헬퍼 함수\n */\nexport function createRealtimeManager(\n  client: RealtimeClient,\n): CoreRealtimeManager {\n  return new RealtimeManagerImpl(client);\n}\n","import {\n  Emotion,\n  type RealtimeSessionConfig,\n  type RealtimeTool,\n} from \"@charivo/core\";\n\n/**\n * Get emotion enum values for tool definition\n */\nconst EMOTION_VALUES = Object.values(Emotion);\n\n/**\n * setEmotion tool definition for OpenAI Realtime API\n *\n * This tool allows the LLM to update the Live2D character's emotion.\n */\nexport const setEmotionTool: RealtimeTool = {\n  type: \"function\",\n  name: \"setEmotion\",\n  description:\n    \"Update Live2D character emotion. Call this when the conversation mood or emotion changes.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      emotion: {\n        type: \"string\",\n        description: \"Emotion of the character.\",\n        enum: EMOTION_VALUES,\n      },\n    },\n    required: [\"emotion\"],\n  },\n};\n\n/**\n * Emotion tool call arguments type\n */\nexport interface EmotionArgs {\n  emotion: Emotion;\n}\n\n/**\n * Default instructions for character with emotion support\n */\nexport const DEFAULT_EMOTION_INSTRUCTIONS = `\nYou are a Live2D character with emotions and expressions.\nRespond naturally to the user's messages.\nWhen the conversation mood or emotion changes, call the 'setEmotion' tool to update your expression and motion.\nDo NOT mention the tool call in your response - just respond naturally and let the emotion show through your character.\n`.trim();\n\n/**\n * Get default Realtime session config with emotion support\n */\nexport function getEmotionSessionConfig(overrides?: RealtimeSessionConfig): {\n  type: string;\n  model: string;\n  audio: { output: { voice: string } };\n  instructions: string;\n  tools: RealtimeTool[];\n  tool_choice: \"auto\" | \"none\" | \"required\";\n} {\n  const toolsFromConfig = overrides?.tools ?? [];\n  const hasEmotionTool = toolsFromConfig.some(\n    (tool) => tool.type === \"function\" && tool.name === setEmotionTool.name,\n  );\n  const tools = hasEmotionTool\n    ? toolsFromConfig\n    : [setEmotionTool, ...toolsFromConfig];\n\n  return {\n    type: \"realtime\",\n    model: overrides?.model || \"gpt-realtime-mini\",\n    audio: {\n      output: {\n        voice: overrides?.voice || \"marin\",\n      },\n    },\n    instructions: overrides?.instructions || DEFAULT_EMOTION_INSTRUCTIONS,\n    tools,\n    tool_choice: overrides?.tool_choice ?? \"auto\",\n  };\n}\n"]}

package/package.json

@@ -1,11 +1,19 @@
 {
   "name": "@charivo/realtime-core",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Core utilities for Realtime API functionality in Charivo",
   "main": "dist/index.js",
+  "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
   "dependencies": {
-    "@charivo/core": "0.0.1"
+    "@charivo/core": "0.1.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",
@@ -34,6 +42,7 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
   }
 }