@aituber-onair/chat 0.1.0

package/dist/cjs/services/providers/openai/OpenAIChatServiceProvider.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIChatServiceProvider = void 0;
+const constants_1 = require("../../../constants");
+const OpenAIChatService_1 = require("./OpenAIChatService");
+/**
+ * OpenAI API provider implementation
+ */
+class OpenAIChatServiceProvider {
+    /**
+     * Create a chat service instance
+     * @param options Service options
+     * @returns OpenAIChatService instance
+     */
+    createChatService(options) {
+        // Use the visionModel if provided, otherwise use the model that supports vision
+        const visionModel = options.visionModel ||
+            (this.supportsVisionForModel(options.model || this.getDefaultModel())
+                ? options.model
+                : this.getDefaultModel());
+        // tools definition
+        const tools = options.tools;
+        // if MCP servers are set, automatically use Responses API
+        const mcpServers = options.mcpServers ?? [];
+        const shouldUseResponsesAPI = mcpServers.length > 0;
+        const endpoint = options.endpoint ||
+            (shouldUseResponsesAPI
+                ? constants_1.ENDPOINT_OPENAI_RESPONSES_API
+                : constants_1.ENDPOINT_OPENAI_CHAT_COMPLETIONS_API);
+        return new OpenAIChatService_1.OpenAIChatService(options.apiKey, options.model || this.getDefaultModel(), visionModel, tools, endpoint, mcpServers, options.responseLength);
+    }
+    /**
+     * Get the provider name
+     * @returns Provider name ('openai')
+     */
+    getProviderName() {
+        return 'openai';
+    }
+    /**
+     * Get the list of supported models
+     * @returns Array of supported model names
+     */
+    getSupportedModels() {
+        return [
+            constants_1.MODEL_GPT_4_1,
+            constants_1.MODEL_GPT_4_1_MINI,
+            constants_1.MODEL_GPT_4_1_NANO,
+            constants_1.MODEL_GPT_4O_MINI,
+            constants_1.MODEL_GPT_4O,
+            constants_1.MODEL_O3_MINI,
+            constants_1.MODEL_O1_MINI,
+            constants_1.MODEL_O1,
+            constants_1.MODEL_GPT_4_5_PREVIEW,
+        ];
+    }
+    /**
+     * Get the default model
+     * @returns Default model name
+     */
+    getDefaultModel() {
+        return constants_1.MODEL_GPT_4O_MINI;
+    }
+    /**
+     * Check if this provider supports vision (image processing)
+     * @returns Vision support status (true)
+     */
+    supportsVision() {
+        return true;
+    }
+    /**
+     * Check if a specific model supports vision capabilities
+     * @param model The model name to check
+     * @returns True if the model supports vision, false otherwise
+     */
+    supportsVisionForModel(model) {
+        return constants_1.VISION_SUPPORTED_MODELS.includes(model);
+    }
+}
+exports.OpenAIChatServiceProvider = OpenAIChatServiceProvider;
+//# sourceMappingURL=OpenAIChatServiceProvider.js.map

package/dist/cjs/services/providers/openai/OpenAIChatServiceProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIChatServiceProvider.js","sourceRoot":"","sources":["../../../../../src/services/providers/openai/OpenAIChatServiceProvider.ts"],"names":[],"mappings":";;;AAAA,kDAa4B;AAE5B,2DAAwD;AAOxD;;GAEG;AACH,MAAa,yBAAyB;IACpC;;;;OAIG;IACH,iBAAiB,CAAC,OAA2B;QAC3C,gFAAgF;QAChF,MAAM,WAAW,GACf,OAAO,CAAC,WAAW;YACnB,CAAC,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACnE,CAAC,CAAC,OAAO,CAAC,KAAK;gBACf,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;QAE9B,mBAAmB;QACnB,MAAM,KAAK,GAAiC,OAAO,CAAC,KAAK,CAAC;QAE1D,0DAA0D;QAC1D,MAAM,UAAU,GAAI,OAAe,CAAC,UAAU,IAAI,EAAE,CAAC;QACrD,MAAM,qBAAqB,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACpD,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ;YAChB,CAAC,qBAAqB;gBACpB,CAAC,CAAC,yCAA6B;gBAC/B,CAAC,CAAC,gDAAoC,CAAC,CAAC;QAE5C,OAAO,IAAI,qCAAiB,CAC1B,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,eAAe,EAAE,EACvC,WAAW,EACX,KAAK,EACL,QAAQ,EACR,UAAU,EACV,OAAO,CAAC,cAAc,CACvB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,eAAe;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,kBAAkB;QAChB,OAAO;YACL,yBAAa;YACb,8BAAkB;YAClB,8BAAkB;YAClB,6BAAiB;YACjB,wBAAY;YACZ,yBAAa;YACb,yBAAa;YACb,oBAAQ;YACR,iCAAqB;SACtB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,eAAe;QACb,OAAO,6BAAiB,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,sBAAsB,CAAC,KAAa;QAClC,OAAO,mCAAuB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;CACF;AAvFD,8DAuFC"}

package/dist/cjs/types/chat.d.ts

@@ -0,0 +1,46 @@
+/**
+ * AITuber OnAir Core type definitions
+ */
+/**
+ * Chat message basic type
+ */
+export interface Message {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    timestamp?: number;
+}
+/**
+ * Vision block type for image content
+ */
+export type VisionBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+        detail?: 'low' | 'high' | 'auto';
+    };
+};
+/**
+ * Message type corresponding to vision (image)
+ */
+export interface MessageWithVision {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | VisionBlock[];
+}
+/**
+ * Chat type
+ * - chatForm: Chat from text input
+ * - youtube: Chat from YouTube comments
+ * - vision: Chat from vision (image)
+ */
+export type ChatType = 'chatForm' | 'youtube' | 'vision';
+/**
+ * screenplay (text with emotion)
+ */
+export interface Screenplay {
+    text: string;
+    emotion?: string;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/cjs/types/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/types/chat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE;QACT,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;KAClC,CAAC;CACH,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/cjs/types/chat.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * AITuber OnAir Core type definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=chat.js.map

package/dist/cjs/types/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../src/types/chat.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/cjs/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AITuber OnAir Chat type definitions
+ * Index file: Export all type definitions from here
+ */
+export { Message, MessageWithVision, VisionBlock, ChatType, Screenplay, } from './chat';
+export * from './toolChat';
+export * from './mcp';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,UAAU,GACX,MAAM,QAAQ,CAAC;AAGhB,cAAc,YAAY,CAAC;AAG3B,cAAc,OAAO,CAAC"}

package/dist/cjs/types/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * AITuber OnAir Chat type definitions
+ * Index file: Export all type definitions from here
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Tool related type definitions
+__exportStar(require("./toolChat"), exports);
+// MCP related type definitions
+__exportStar(require("./mcp"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAWH,gCAAgC;AAChC,6CAA2B;AAE3B,+BAA+B;AAC/B,wCAAsB"}

package/dist/cjs/types/mcp.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Model Context Protocol (MCP) related types
+ */
+/**
+ * MCP server configuration for MCP connector
+ * This is a standard configuration format that may be used by multiple providers
+ */
+export interface MCPServerConfig {
+    type: 'url';
+    url: string;
+    name: string;
+    tool_configuration?: {
+        enabled?: boolean;
+        allowed_tools?: string[];
+    };
+    authorization_token?: string;
+}
+/**
+ * Claude-specific MCP tool use block (internal type for Claude)
+ */
+export interface ClaudeMCPToolUseBlock {
+    type: 'mcp_tool_use';
+    id: string;
+    name: string;
+    server_name: string;
+    input: any;
+}
+/**
+ * Claude-specific MCP tool result block (internal type for Claude)
+ */
+export interface ClaudeMCPToolResultBlock {
+    type: 'mcp_tool_result';
+    tool_use_id: string;
+    is_error: boolean;
+    content: any[];
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/cjs/types/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/types/mcp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,GAAG,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,GAAG,EAAE,CAAC;CAChB"}

package/dist/cjs/types/mcp.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Model Context Protocol (MCP) related types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mcp.js.map

package/dist/cjs/types/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/types/mcp.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/cjs/types/toolChat.d.ts

@@ -0,0 +1,42 @@
+export interface TextBlock {
+    type: 'text';
+    text: string;
+}
+export interface ToolUseBlock<P = any> {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: P;
+}
+export interface ToolResultBlock {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+}
+export type CoreToolChatBlock = TextBlock | ToolUseBlock | ToolResultBlock;
+export interface ToolChatCompletion<B = CoreToolChatBlock> {
+    blocks: B[];
+    stop_reason: 'tool_use' | 'end';
+}
+export type ToolChatBlock = CoreToolChatBlock;
+export type ToolDefinition = {
+    name: string;
+    description?: string;
+    parameters: {
+        type: 'object';
+        properties?: Record<string, {
+            type?: string;
+            description?: string;
+            enum?: any[];
+            items?: any;
+            required?: string[];
+            [key: string]: any;
+        }>;
+        required?: string[];
+        [key: string]: any;
+    };
+    config?: {
+        timeoutMs?: number;
+    };
+};
+//# sourceMappingURL=toolChat.d.ts.map

package/dist/cjs/types/toolChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolChat.d.ts","sourceRoot":"","sources":["../../../src/types/toolChat.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,GAAG;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,CAAC;CACV;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,YAAY,GAAG,eAAe,CAAC;AAE3E,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,iBAAiB;IACvD,MAAM,EAAE,CAAC,EAAE,CAAC;IACZ,WAAW,EAAE,UAAU,GAAG,KAAK,CAAC;CACjC;AACD,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE9C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CACjB,MAAM,EACN;YACE,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,EAAE,GAAG,CAAC;YACZ,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;YACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;SACpB,CACF,CAAC;QACF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjC,CAAC"}

package/dist/cjs/types/toolChat.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=toolChat.js.map

package/dist/cjs/types/toolChat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolChat.js","sourceRoot":"","sources":["../../../src/types/toolChat.ts"],"names":[],"mappings":""}

package/dist/cjs/utils/chatServiceHttpClient.d.ts

@@ -0,0 +1,47 @@
+/**
+ * HTTP client options
+ */
+export interface HttpClientOptions {
+    headers?: Record<string, string>;
+    timeout?: number;
+    retries?: number;
+    retryDelay?: number;
+}
+/**
+ * HTTP error response
+ */
+export declare class HttpError extends Error {
+    status: number;
+    statusText: string;
+    body: string;
+    constructor(status: number, statusText: string, body: string);
+}
+/**
+ * Unified HTTP client for chat services
+ */
+export declare class ChatServiceHttpClient {
+    /**
+     * Make a POST request with common error handling
+     * @param url Request URL
+     * @param body Request body
+     * @param headers Request headers
+     * @param options Additional options
+     * @returns Response object
+     */
+    static post(url: string, body: any, headers?: Record<string, string>, options?: HttpClientOptions): Promise<Response>;
+    /**
+     * Handle error response and throw appropriate error
+     * @param res Response object
+     * @returns Never (always throws)
+     */
+    static handleErrorResponse(res: Response): Promise<never>;
+    /**
+     * Make a GET request (for fetching images, etc.)
+     * @param url Request URL
+     * @param headers Request headers
+     * @param options Additional options
+     * @returns Response object
+     */
+    static get(url: string, headers?: Record<string, string>, options?: HttpClientOptions): Promise<Response>;
+}
+//# sourceMappingURL=chatServiceHttpClient.d.ts.map

package/dist/cjs/utils/chatServiceHttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatServiceHttpClient.d.ts","sourceRoot":"","sources":["../../../src/utils/chatServiceHttpClient.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAEzB,MAAM,EAAE,MAAM;IACd,UAAU,EAAE,MAAM;IAClB,IAAI,EAAE,MAAM;gBAFZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM;CAKtB;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;;;;;;OAOG;WACU,IAAI,CACf,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,GAAG,EACT,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,QAAQ,CAAC;IA6DpB;;;;OAIG;WACU,mBAAmB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC;IAK/D;;;;;;OAMG;WACU,GAAG,CACd,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,QAAQ,CAAC;CAoDrB"}

package/dist/cjs/utils/chatServiceHttpClient.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatServiceHttpClient = exports.HttpError = void 0;
+/**
+ * HTTP error response
+ */
+class HttpError extends Error {
+    constructor(status, statusText, body) {
+        super(`HTTP ${status}: ${statusText}`);
+        this.status = status;
+        this.statusText = statusText;
+        this.body = body;
+        this.name = 'HttpError';
+    }
+}
+exports.HttpError = HttpError;
+/**
+ * Unified HTTP client for chat services
+ */
+class ChatServiceHttpClient {
+    /**
+     * Make a POST request with common error handling
+     * @param url Request URL
+     * @param body Request body
+     * @param headers Request headers
+     * @param options Additional options
+     * @returns Response object
+     */
+    static async post(url, body, headers = {}, options = {}) {
+        const { timeout = 30000, retries = 0, retryDelay = 1000 } = options;
+        // Default headers
+        const defaultHeaders = {
+            'Content-Type': 'application/json',
+        };
+        const finalHeaders = { ...defaultHeaders, ...headers };
+        let lastError = null;
+        for (let attempt = 0; attempt <= retries; attempt++) {
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), timeout);
+                const response = await fetch(url, {
+                    method: 'POST',
+                    headers: finalHeaders,
+                    body: typeof body === 'string' ? body : JSON.stringify(body),
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (!response.ok) {
+                    const errorBody = await response.text();
+                    throw new HttpError(response.status, response.statusText, errorBody);
+                }
+                return response;
+            }
+            catch (error) {
+                lastError = error;
+                // Don't retry on client errors (4xx)
+                if (error instanceof HttpError &&
+                    error.status >= 400 &&
+                    error.status < 500) {
+                    throw error;
+                }
+                // Don't retry if aborted
+                if (error instanceof Error && error.name === 'AbortError') {
+                    throw new Error(`Request timeout after ${timeout}ms`);
+                }
+                // Wait before retrying
+                if (attempt < retries) {
+                    await new Promise((resolve) => setTimeout(resolve, retryDelay * (attempt + 1)));
+                }
+            }
+        }
+        throw lastError || new Error('Request failed');
+    }
+    /**
+     * Handle error response and throw appropriate error
+     * @param res Response object
+     * @returns Never (always throws)
+     */
+    static async handleErrorResponse(res) {
+        const errorBody = await res.text();
+        throw new HttpError(res.status, res.statusText, errorBody);
+    }
+    /**
+     * Make a GET request (for fetching images, etc.)
+     * @param url Request URL
+     * @param headers Request headers
+     * @param options Additional options
+     * @returns Response object
+     */
+    static async get(url, headers = {}, options = {}) {
+        const { timeout = 30000, retries = 0, retryDelay = 1000 } = options;
+        let lastError = null;
+        for (let attempt = 0; attempt <= retries; attempt++) {
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), timeout);
+                const response = await fetch(url, {
+                    method: 'GET',
+                    headers,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (!response.ok) {
+                    const errorBody = await response.text();
+                    throw new HttpError(response.status, response.statusText, errorBody);
+                }
+                return response;
+            }
+            catch (error) {
+                lastError = error;
+                // Don't retry on client errors (4xx)
+                if (error instanceof HttpError &&
+                    error.status >= 400 &&
+                    error.status < 500) {
+                    throw error;
+                }
+                // Don't retry if aborted
+                if (error instanceof Error && error.name === 'AbortError') {
+                    throw new Error(`Request timeout after ${timeout}ms`);
+                }
+                // Wait before retrying
+                if (attempt < retries) {
+                    await new Promise((resolve) => setTimeout(resolve, retryDelay * (attempt + 1)));
+                }
+            }
+        }
+        throw lastError || new Error('Request failed');
+    }
+}
+exports.ChatServiceHttpClient = ChatServiceHttpClient;
+//# sourceMappingURL=chatServiceHttpClient.js.map

package/dist/cjs/utils/chatServiceHttpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatServiceHttpClient.js","sourceRoot":"","sources":["../../../src/utils/chatServiceHttpClient.ts"],"names":[],"mappings":"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"}

package/dist/cjs/utils/emotionParser.d.ts

@@ -0,0 +1,46 @@
+declare const emotions: readonly ["happy", "sad", "angry", "surprised", "neutral"];
+type EmotionType = (typeof emotions)[number];
+/**
+ * Regular expressions for emotion tag parsing
+ */
+export declare const EMOTION_TAG_REGEX: RegExp;
+export declare const EMOTION_TAG_CLEANUP_REGEX: RegExp;
+/**
+ * Result of emotion extraction
+ */
+export interface EmotionExtractionResult {
+    emotion?: string;
+    cleanText: string;
+}
+/**
+ * Utility class for parsing and handling emotion tags in text
+ */
+export declare class EmotionParser {
+    /**
+     * Extract emotion from text and return clean text
+     * @param text Text that may contain emotion tags like [happy]
+     * @returns Object containing extracted emotion and clean text
+     */
+    static extractEmotion(text: string): EmotionExtractionResult;
+    /**
+     * Check if an emotion is valid
+     * @param emotion Emotion string to validate
+     * @returns True if the emotion is valid
+     */
+    static isValidEmotion(emotion: string): emotion is EmotionType;
+    /**
+     * Remove all emotion tags from text
+     * @param text Text containing emotion tags
+     * @returns Clean text without emotion tags
+     */
+    static cleanEmotionTags(text: string): string;
+    /**
+     * Add emotion tag to text
+     * @param emotion Emotion to add
+     * @param text Text content
+     * @returns Text with emotion tag prepended
+     */
+    static addEmotionTag(emotion: string, text: string): string;
+}
+export {};
+//# sourceMappingURL=emotionParser.d.ts.map

package/dist/cjs/utils/emotionParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotionParser.d.ts","sourceRoot":"","sources":["../../../src/utils/emotionParser.ts"],"names":[],"mappings":"AACA,QAAA,MAAM,QAAQ,4DAA6D,CAAC;AAC5E,KAAK,WAAW,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAkB,CAAC;AACjD,eAAO,MAAM,yBAAyB,QAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB;IAe5D;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,WAAW;IAI9D;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI7C;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;CAG5D"}

package/dist/cjs/utils/emotionParser.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmotionParser = exports.EMOTION_TAG_CLEANUP_REGEX = exports.EMOTION_TAG_REGEX = void 0;
+// Define emotion types and list locally to avoid dependency on voice package
+const emotions = ['happy', 'sad', 'angry', 'surprised', 'neutral'];
+/**
+ * Regular expressions for emotion tag parsing
+ */
+exports.EMOTION_TAG_REGEX = /\[([a-z]+)\]/i;
+exports.EMOTION_TAG_CLEANUP_REGEX = /\[[a-z]+\]\s*/gi;
+/**
+ * Utility class for parsing and handling emotion tags in text
+ */
+class EmotionParser {
+    /**
+     * Extract emotion from text and return clean text
+     * @param text Text that may contain emotion tags like [happy]
+     * @returns Object containing extracted emotion and clean text
+     */
+    static extractEmotion(text) {
+        const match = text.match(exports.EMOTION_TAG_REGEX);
+        if (match) {
+            const emotion = match[1].toLowerCase();
+            const cleanText = text.replace(exports.EMOTION_TAG_CLEANUP_REGEX, '').trim();
+            return {
+                emotion,
+                cleanText,
+            };
+        }
+        return { cleanText: text };
+    }
+    /**
+     * Check if an emotion is valid
+     * @param emotion Emotion string to validate
+     * @returns True if the emotion is valid
+     */
+    static isValidEmotion(emotion) {
+        return emotions.includes(emotion);
+    }
+    /**
+     * Remove all emotion tags from text
+     * @param text Text containing emotion tags
+     * @returns Clean text without emotion tags
+     */
+    static cleanEmotionTags(text) {
+        return text.replace(exports.EMOTION_TAG_CLEANUP_REGEX, '').trim();
+    }
+    /**
+     * Add emotion tag to text
+     * @param emotion Emotion to add
+     * @param text Text content
+     * @returns Text with emotion tag prepended
+     */
+    static addEmotionTag(emotion, text) {
+        return `[${emotion}] ${text}`;
+    }
+}
+exports.EmotionParser = EmotionParser;
+//# sourceMappingURL=emotionParser.js.map

package/dist/cjs/utils/emotionParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotionParser.js","sourceRoot":"","sources":["../../../src/utils/emotionParser.ts"],"names":[],"mappings":";;;AAAA,6EAA6E;AAC7E,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,CAAU,CAAC;AAG5E;;GAEG;AACU,QAAA,iBAAiB,GAAG,eAAe,CAAC;AACpC,QAAA,yBAAyB,GAAG,iBAAiB,CAAC;AAU3D;;GAEG;AACH,MAAa,aAAa;IACxB;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,IAAY;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,yBAAiB,CAAC,CAAC;QAE5C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,iCAAyB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACrE,OAAO;gBACL,OAAO;gBACP,SAAS;aACV,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,OAAe;QACnC,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAc,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAY;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,iCAAyB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,OAAe,EAAE,IAAY;QAChD,OAAO,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;IAChC,CAAC;CACF;AAhDD,sCAgDC"}

package/dist/cjs/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Utilities for AITuber OnAir Chat
+ */
+export * from './chatServiceHttpClient';
+export * from './streamTextAccumulator';
+export * from './screenplay';
+export * from './emotionParser';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/cjs/utils/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Utilities for AITuber OnAir Chat
+ */
+__exportStar(require("./chatServiceHttpClient"), exports);
+__exportStar(require("./streamTextAccumulator"), exports);
+__exportStar(require("./screenplay"), exports);
+__exportStar(require("./emotionParser"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,0DAAwC;AACxC,0DAAwC;AACxC,+CAA6B;AAC7B,kDAAgC"}