@metatell/bot-sdk 0.0.1

package/dist/client.d.ts

@@ -0,0 +1,127 @@
+/**
+ * MetatellClient implementation - main facade for SDK
+ */
+import type { Animation, AvatarAsset, BotInfo, CreateClientOptions, Euler, MetatellClientEvents, PcmInput, PcmInputOptions, PlaybackControls, User, Vec3 } from './types.js';
+/**
+ * MetatellClient - メインのfacadeインターフェース
+ */
+export interface MetatellClient {
+    /**
+     * Metatellサーバーに接続し、指定されたルームに参加します。
+     * @throws {AuthError} 認証トークンが無効な場合。
+     * @throws {NetworkError} ネットワーク接続に失敗した場合。
+     */
+    connect(): Promise<void>;
+    /**
+     * サーバーから切断します。
+     */
+    disconnect(): Promise<void>;
+    /** ルーム関連の操作 */
+    readonly room: {
+        /** 現在ルームに参加しているユーザーの一覧を取得します。 */
+        getUsers(): Promise<User[]>;
+        /** 指定した半径内のユーザーを取得します。 */
+        getNearbyUsers(radius?: number): Promise<User[]>;
+    };
+    /** 現在ルームに参加しているユーザーの一覧を取得します（同期版）。 */
+    getUsers(): User[];
+    /** チャット関連の操作 */
+    readonly chat: {
+        /** ルーム全体にメッセージを送信します。 */
+        send(text: string): Promise<void>;
+        /**
+         * すべてのチャットメッセージを購読します。
+         * メンションの有無に関わらず、すべてのメッセージを受信します。
+         */
+        onMessage(handler: (event: {
+            from: User;
+            text: string;
+            mention?: {
+                sessionId: string;
+                name: string;
+            };
+            /** 受信したメッセージに簡易返信するユーティリティ関数 */
+            reply: (text: string) => Promise<void>;
+        }) => void): void;
+    };
+    /** ボットアバターの操作 */
+    readonly avatar: {
+        /**
+         * アバターを選択・変更します。
+         * @param assetId 組織アバターのIDなど
+         */
+        select(assetId: string): Promise<void>;
+        /**
+         * アニメーションを再生します。
+         * @param animation 再生するアニメーションの仕様
+         * @throws {NotFoundError} 指定されたアニメーションが存在しない場合。
+         */
+        play(animation: Animation): Promise<void>;
+        /**
+         * 指定された座標に移動します。
+         * @param position 移動先の座標（メートル）
+         */
+        moveTo(position: Vec3): Promise<void>;
+        /**
+         * 指定された角度に回転します。
+         * @param rotation 回転角度（オイラー角・度数法）
+         */
+        rotateTo(rotation: Euler): Promise<void>;
+        /**
+         * 指定された座標を見るように回転します。
+         * @param target 見る対象の座標（メートル）
+         */
+        lookAt(target: Vec3): Promise<void>;
+        /** 現在の位置を取得します。 */
+        getPosition(): Vec3 | null;
+        /** 利用可能なアバターアセットの一覧を取得します。 */
+        getAvailableAssets(): Promise<AvatarAsset[]>;
+        /** 現在のアバターで利用可能なアニメーションの一覧を取得します。 */
+        getAvailableAnimations(): Promise<Animation[]>;
+    };
+    /** 音声関連の操作 */
+    readonly voice: {
+        /**
+         * 16-bit PCMデータを注入し、ボットに発話させます。
+         * SDKは内部で48kHz/monoにリサンプリングし、10msのフレームに分割して送信します。
+         * @param input Int16Array, AsyncIterable<Int16Array>, またはNodeJS.ReadableStream
+         * @param options 入力PCMのフォーマット
+         * @returns 再生を制御するためのオブジェクト
+         * @throws {UnsupportedAudioFormatError} サポート外のフォーマットが指定された場合。
+         */
+        playPcm(input: PcmInput, options: PcmInputOptions): Promise<PlaybackControls>;
+    };
+    /** ボット自身の情報を取得します。 */
+    getInfo(): Promise<BotInfo>;
+    /** 接続状態を取得します。 */
+    getStatus(): {
+        connected: boolean;
+        connecting: boolean;
+    };
+    /** レート制限設定を取得します。 */
+    getRateLimit(key: 'messages' | 'moves' | 'looks'): number | undefined;
+    /** レート制限を設定します。 */
+    setRateLimit(key: 'messages' | 'moves' | 'looks', perSecond: number): void;
+    /**
+     * 現在のセッションIDを取得します。
+     */
+    getSessionId(): string | null;
+    /**
+     * SDKのイベントを購読します。
+     * @param event イベント名
+     * @param listener イベントハンドラ
+     */
+    on<E extends keyof MetatellClientEvents>(event: E, listener: MetatellClientEvents[E]): this;
+    /**
+     * SDKのイベント購読を解除します。
+     */
+    off<E extends keyof MetatellClientEvents>(event: E, listener: MetatellClientEvents[E]): this;
+}
+/**
+ * MetatellClientのインスタンスを生成し、初期化します。
+ * @param options クライアント設定
+ * @returns MetatellClientのインスタンス
+ * @throws {MetatellError} 設定が不正な場合にスローされます。
+ */
+export declare function createMetatellClient(options: CreateClientOptions): MetatellClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,552 @@
+/**
+ * MetatellClient implementation - main facade for SDK
+ */
+import { EventEmitter } from 'node:events';
+import { AnimationService, AppSettings, AvatarController, ConfigurationProvider, ConnectionManager, 
+// Core logging provider utilities (to ensure provider is set)
+DefaultLoggerProvider as CoreDefaultLoggerProvider, CoreServiceFactory, EventBus, MessageService, OrganizationService, PresenceManager, registerLoggerProvider as registerCoreLoggerProvider, SystemEvents, UserAvatarManager, } from '@metatell/bot-core';
+import { getLogger } from './sdk/logging/index.js';
+import { RateLimitedQueue } from './sdk/rate.js';
+import { AuthError, MetatellError, NetworkError, NotFoundError } from './types.js';
+/**
+ * MetatellClient実装
+ */
+class MetatellClientImpl extends EventEmitter {
+    options;
+    serviceFactory;
+    connectionManager;
+    messageService;
+    avatarController;
+    presenceManager;
+    organizationService;
+    animationService;
+    eventBus;
+    configProvider;
+    userAvatarManager;
+    rateLimiter = new RateLimitedQueue();
+    logger = getLogger('MetatellClient');
+    constructor(options) {
+        super();
+        this.options = options;
+        // Ensure Core logging provider is registered to avoid runtime error
+        try {
+            // CoreServiceFactoryがプロバイダーを必要とする場合のみ登録
+            registerCoreLoggerProvider(new CoreDefaultLoggerProvider(), { allowOverwrite: true });
+        }
+        catch {
+            // すでに登録されている場合はエラーを無視
+        }
+        // デバッグモードの場合、ロギングを有効化
+        if (options.debug) {
+            process.env.DEBUG = 'metatell:*';
+        }
+        // CoreServiceFactoryを初期化
+        this.serviceFactory = new CoreServiceFactory({
+            serverUrl: options.serverUrl,
+            hubUrl: options.serverUrl.replace(/^ws/, 'http'), // WebSocket URLからHTTP URLに変換
+            hubId: options.roomId,
+            profile: {
+                displayName: options.username || 'MetatellBot',
+                avatarId: options.avatarId || '', // 後で組織アバターから取得
+            },
+            debug: options.debug || false,
+        });
+        // 必要なサービスを取得
+        const container = this.serviceFactory.getContainer();
+        this.connectionManager = container.get(ConnectionManager);
+        this.messageService = container.get(MessageService);
+        this.avatarController = container.get(AvatarController);
+        this.presenceManager = container.get(PresenceManager);
+        this.userAvatarManager = container.get(UserAvatarManager);
+        this.organizationService = container.get(OrganizationService);
+        this.animationService = container.get(AnimationService);
+        this.eventBus = container.get(EventBus);
+        this.configProvider = container.get(ConfigurationProvider);
+        // デバッグモードの場合、AppSettingsのログレベルを変更
+        if (options.debug) {
+            const appSettings = container.get(AppSettings);
+            appSettings.setLogLevel('debug');
+            appSettings.setDebugMode(true);
+        }
+        // イベントのプロキシ設定
+        this.setupEventProxies();
+    }
+    /**
+     * Parse mention from message body
+     * Format: [@displayName](session-id) message
+     * Example: [@MetatellCLI](b754ca96-d395-4b80-adb1-77cb0240a43d) hello
+     */
+    parseMessageMention(body) {
+        const mentionPattern = /\[@([^\]]+)\]\(([^)]+)\)\s*(.*)$/;
+        const match = body.match(mentionPattern);
+        if (match) {
+            return {
+                text: match[3].trim(),
+                mention: {
+                    name: match[1],
+                    sessionId: match[2],
+                },
+            };
+        }
+        return { text: body };
+    }
+    setupEventProxies() {
+        // Coreのイベントをクライアントイベントにマッピング
+        this.eventBus.on(SystemEvents.CONNECTION_ESTABLISHED, () => {
+            this.emit('connected');
+        });
+        this.eventBus.on(SystemEvents.CONNECTION_LOST, () => {
+            this.emit('disconnected');
+        });
+        this.eventBus.on(SystemEvents.MESSAGE_RECEIVED, (data) => {
+            const messageData = data;
+            this.emit('message', messageData);
+            // チャットメッセージの場合、詳細な情報を解析して別イベントを発火
+            if (messageData.type === 'chat' && messageData.body) {
+                const parsed = this.parseMessageMention(messageData.body);
+                // PresenceManagerから送信者の情報を取得
+                const users = this.presenceManager.getUsers();
+                const sender = users.find((u) => u.id === messageData.senderId);
+                // デバッグ情報
+                if (this.options.debug) {
+                    this.logger.debug('Message sender lookup:', {
+                        senderId: messageData.senderId,
+                        foundSender: !!sender,
+                        senderData: sender,
+                        allUsers: users.map((u) => ({ id: u.id, name: u.profile?.displayName })),
+                    });
+                }
+                const senderName = sender?.profile?.displayName || sender?.id.split('#')[0] || 'Unknown';
+                this.emit('chat-message', {
+                    from: {
+                        id: messageData.senderId || '',
+                        name: senderName,
+                        isBot: false,
+                    },
+                    text: parsed.text,
+                    mention: parsed.mention,
+                });
+            }
+        });
+        this.eventBus.on(SystemEvents.USER_JOINED, (data) => {
+            // PresenceUserデータをUser型に変換
+            const presenceUser = data;
+            // UserAvatarManagerからアバター情報を取得
+            const avatar = this.userAvatarManager.getUser(presenceUser.id);
+            const user = {
+                id: presenceUser.id,
+                name: presenceUser.profile?.displayName || presenceUser.id.split('#')[0] || presenceUser.id,
+                isBot: false,
+                position: avatar?.position,
+                rotation: avatar?.rotation,
+            };
+            this.emit('user-join', user);
+            // 新しいユーザーが入室したときにアバターを再同期
+            this.resyncAvatarForNewUser();
+        });
+        this.eventBus.on(SystemEvents.USER_LEFT, (data) => {
+            // PresenceUserデータをUser型に変換
+            const presenceUser = data;
+            // UserAvatarManagerからアバター情報を取得
+            const avatar = this.userAvatarManager.getUser(presenceUser.id);
+            const user = {
+                id: presenceUser.id,
+                name: presenceUser.profile?.displayName || presenceUser.id.split('#')[0] || presenceUser.id,
+                isBot: false,
+                position: avatar?.position,
+                rotation: avatar?.rotation,
+            };
+            this.emit('user-leave', user);
+        });
+    }
+    async resyncAvatarForNewUser() {
+        try {
+            // アバターがスポーンされている場合のみ再同期
+            if (this.avatarController.getState()) {
+                await this.avatarController.resyncAvatar();
+                this.logger.debug('Avatar resynced for new user');
+            }
+        }
+        catch (error) {
+            this.logger.warn('Failed to resync avatar for new user', error);
+        }
+    }
+    async connect() {
+        try {
+            await this.connectionManager.connect({
+                serverUrl: this.options.serverUrl,
+                hubId: this.options.roomId,
+            });
+            // 組織情報を取得
+            const orgInfo = await this.organizationService.getOrganizationInfo(this.options.serverUrl.replace(/^ws/, 'http'), this.options.roomId);
+            // アバターIDが指定されていない場合、組織アバターから選択
+            let avatarId = this.options.avatarId;
+            let avatarUrl;
+            if (!avatarId && orgInfo.organizationId) {
+                try {
+                    // 組織アバター一覧を取得
+                    const avatars = await this.organizationService.fetchOrganizationAvatars(this.options.serverUrl.replace(/^ws/, 'http'), orgInfo.organizationId);
+                    if (avatars.length > 0) {
+                        // 最初のアバターを使用
+                        const defaultAvatar = avatars[0];
+                        avatarId = defaultAvatar.id;
+                        avatarUrl = defaultAvatar.gltf.avatar;
+                    }
+                }
+                catch (error) {
+                    // 組織アバター取得に失敗した場合はスキップ
+                    this.logger.debug('Failed to fetch organization avatars', error);
+                }
+            }
+            // アバターIDが取得できない場合はエラー
+            if (!avatarId) {
+                throw new MetatellError('NO_AVATAR_AVAILABLE', 'No avatar available. Organization avatars not found and no avatar ID specified.');
+            }
+            // アバターをスポーン
+            if (avatarId) {
+                // 設定を更新
+                const config = this.configProvider.getConfiguration();
+                config.profile.avatarId = avatarId;
+                if (avatarUrl) {
+                    config.organizationAvatarUrl = avatarUrl;
+                }
+                await this.avatarController.spawn(avatarId, undefined, avatarUrl);
+            }
+        }
+        catch (error) {
+            // エラーを適切なタイプに変換
+            if (error instanceof Error && error.message.includes('auth')) {
+                throw new AuthError('AUTH_FAILED', 'Authentication failed', error);
+            }
+            throw new NetworkError('CONNECTION_FAILED', 'Failed to connect', error);
+        }
+    }
+    async disconnect() {
+        await this.connectionManager.disconnect();
+    }
+    room = {
+        getUsers: async () => {
+            const users = this.presenceManager.getUsers();
+            const currentSessionId = this.connectionManager.getSessionId();
+            // PresenceUserをUser型に変換
+            return users.map((u) => {
+                // 自分自身の場合はAvatarControllerから位置情報を取得
+                if (u.id === currentSessionId) {
+                    const avatarState = this.avatarController.getState();
+                    return {
+                        id: u.id,
+                        name: u.profile?.displayName || u.id.split('#')[0] || u.id,
+                        isBot: false,
+                        position: avatarState?.position,
+                        rotation: avatarState?.rotation
+                            ? {
+                                x: (avatarState.rotation.x * 180) / Math.PI,
+                                y: (avatarState.rotation.y * 180) / Math.PI,
+                                z: (avatarState.rotation.z * 180) / Math.PI,
+                                w: 1, // 簡略化
+                            }
+                            : undefined,
+                    };
+                }
+                // UserAvatarManagerからアバター情報を取得
+                const avatar = this.userAvatarManager.getUser(u.id);
+                return {
+                    id: u.id,
+                    name: u.profile?.displayName || u.id.split('#')[0] || u.id,
+                    isBot: false,
+                    position: avatar?.position,
+                    rotation: avatar?.rotation,
+                };
+            });
+        },
+        getNearbyUsers: async (radius = 10) => {
+            // 現在のアバター位置を取得
+            const currentPosition = this.avatar.getPosition();
+            if (!currentPosition) {
+                // アバターがスポーンされていない場合は全ユーザーを返す
+                return this.room.getUsers();
+            }
+            // UserAvatarManagerから距離内のユーザーを取得
+            const nearbyAvatars = this.userAvatarManager.getUsersInRange(currentPosition, radius);
+            // UserAvatarをUser型に変換
+            return nearbyAvatars.map((avatar) => ({
+                id: avatar.id,
+                name: avatar.nickname || avatar.id.split('#')[0] || avatar.id,
+                isBot: false,
+                position: avatar.position,
+                rotation: avatar.rotation,
+            }));
+        },
+    };
+    chat = {
+        send: async (text) => {
+            await this.rateLimiter.execute('messages', async () => {
+                await this.messageService.sendMessage(text);
+            });
+        },
+        onMessage: (handler) => {
+            // メッセージ受信イベントをサブスクライブ
+            this.eventBus.on(SystemEvents.MESSAGE_RECEIVED, async (data) => {
+                const messageData = data;
+                if (messageData.type === 'chat' && messageData.body) {
+                    const parsed = this.parseMessageMention(messageData.body);
+                    // PresenceManagerから送信者の情報を取得
+                    const users = this.presenceManager.getUsers();
+                    const sender = users.find((u) => u.id === messageData.senderId);
+                    const senderName = sender?.profile?.displayName || sender?.id.split('#')[0] || 'Unknown';
+                    const user = {
+                        id: messageData.senderId || '',
+                        name: senderName,
+                        isBot: false,
+                    };
+                    handler({
+                        from: user,
+                        text: parsed.text,
+                        mention: parsed.mention,
+                        reply: async (replyText) => {
+                            await this.messageService.sendMessage(replyText);
+                        },
+                    });
+                }
+            });
+        },
+    };
+    avatar = {
+        select: async (assetId) => {
+            // アバターを変更するには再度spawnを呼び出す
+            const state = this.avatarController.getState();
+            await this.avatarController.spawn(assetId, state?.position);
+        },
+        play: async (animation) => {
+            try {
+                // アニメーションオプションを変換
+                const playOptions = {
+                    loop: animation.loop || false,
+                    duration: animation.duration,
+                    transitionDuration: animation.transitionDuration,
+                };
+                if ('id' in animation && animation.id) {
+                    await this.avatarController.playAnimation(animation.id, playOptions);
+                }
+                else if ('url' in animation && animation.url) {
+                    // URLベースのアニメーションは現在のインターフェースではサポートされていない
+                    // カスタムアニメーションとして扱う必要がある
+                    throw new NotFoundError('ANIMATION_NOT_FOUND', 'URL-based animations are not yet supported');
+                }
+                else {
+                    throw new NotFoundError('ANIMATION_NOT_FOUND', 'Animation must have either id or url');
+                }
+            }
+            catch (error) {
+                if (error instanceof Error && error.message.includes('not found')) {
+                    throw new NotFoundError('ANIMATION_NOT_FOUND', error.message, error);
+                }
+                throw error;
+            }
+        },
+        moveTo: async (position) => {
+            await this.rateLimiter.execute('moves', async () => {
+                await this.avatarController.move(position);
+            });
+        },
+        rotateTo: async (rotation) => {
+            // Euler角（度数法）をラジアンに変換
+            const xRad = (rotation.x * Math.PI) / 180;
+            const yRad = (rotation.y * Math.PI) / 180;
+            const zRad = (rotation.z * Math.PI) / 180;
+            // オイラー角からクォータニオンに変換（ZYX順）
+            const cx = Math.cos(xRad / 2);
+            const sx = Math.sin(xRad / 2);
+            const cy = Math.cos(yRad / 2);
+            const sy = Math.sin(yRad / 2);
+            const cz = Math.cos(zRad / 2);
+            const sz = Math.sin(zRad / 2);
+            const quaternion = {
+                x: sx * cy * cz - cx * sy * sz,
+                y: cx * sy * cz + sx * cy * sz,
+                z: cx * cy * sz - sx * sy * cz,
+                w: cx * cy * cz + sx * sy * sz,
+            };
+            // AvatarControllerのrotateメソッドを使用
+            await this.avatarController.rotate(quaternion);
+        },
+        lookAt: async (target) => {
+            await this.rateLimiter.execute('looks', async () => {
+                // 現在位置を取得
+                const state = this.avatarController.getState();
+                if (!state) {
+                    throw new MetatellError('AVATAR_NOT_SPAWNED', 'Avatar is not spawned');
+                }
+                // ターゲットへの方向ベクトルを計算
+                const dx = target.x - state.position.x;
+                const dz = target.z - state.position.z;
+                // Y軸周りの回転角度を計算（ラジアン）
+                const yRotation = Math.atan2(dx, dz);
+                // ラジアンからクォータニオンに変換（Y軸回転のみ）
+                const halfAngle = yRotation / 2;
+                const quaternion = {
+                    x: 0,
+                    y: Math.sin(halfAngle),
+                    z: 0,
+                    w: Math.cos(halfAngle),
+                };
+                // 回転を適用
+                await this.avatarController.rotate(quaternion);
+            });
+        },
+        getPosition: () => {
+            const state = this.avatarController.getState();
+            return state ? { ...state.position } : null;
+        },
+        getAvailableAssets: async () => {
+            // organizationInfoを取得するには、hubUrlとhubIdが必要
+            const config = this.configProvider.getConfiguration();
+            const orgInfo = await this.organizationService.getOrganizationInfo(config.hubUrl, config.hubId);
+            if (!orgInfo.organizationId) {
+                // 組織IDがない場合は空配列を返す
+                return [];
+            }
+            const avatars = await this.organizationService.fetchOrganizationAvatars(config.hubUrl, orgInfo.organizationId);
+            return avatars.map((avatar) => ({
+                id: avatar.id,
+                name: avatar.name,
+                thumbnailUrl: avatar.images?.preview?.url || avatar.thumbnail_url || '',
+                modelUrl: avatar.gltf.avatar,
+            }));
+        },
+        getAvailableAnimations: async () => {
+            // 現在のアバターIDを取得
+            const state = this.avatarController.getState();
+            if (!state) {
+                return [];
+            }
+            this.logger.debug('Getting available animations for avatar', { avatarId: state.avatarId });
+            const animations = await this.animationService.getAvailableAnimations(state.avatarId);
+            this.logger.debug('Retrieved animations', {
+                avatarId: state.avatarId,
+                animationCount: animations.length,
+                animations: animations.map((a) => ({ id: a.id, name: a.name })),
+            });
+            return animations.map((anim) => ({
+                id: anim.id,
+                name: anim.name || 'Unknown Animation',
+                duration: anim.duration,
+            }));
+        },
+    };
+    voice = {
+        playPcm: async (_input, _options) => {
+            // 音声機能は別パッケージ（@metatell/realtime）で実装
+            // ここではプレースホルダーを返す
+            const finishedPromise = new Promise((resolve) => {
+                setTimeout(resolve, 1000);
+            });
+            return {
+                stop: async () => {
+                    // 音声停止の実装は別パッケージで行う
+                },
+                finished: finishedPromise,
+            };
+        },
+    };
+    async getInfo() {
+        const config = this.configProvider.getConfiguration();
+        const sessionId = this.getSessionId();
+        return {
+            name: config.profile?.displayName || 'MetatellBot',
+            version: '1.0.0',
+            roomId: config.hubId,
+            sessionId: sessionId || undefined,
+        };
+    }
+    getStatus() {
+        // 簡易的な接続状態を返す
+        return {
+            connected: true,
+            connecting: false,
+        };
+    }
+    getUsers() {
+        const users = this.presenceManager.getUsers();
+        const currentSessionId = this.connectionManager.getSessionId();
+        // PresenceUserをUser型に変換（room.getUsersと同じ実装）
+        return users.map((u) => {
+            // 自分自身の場合はAvatarControllerから位置情報を取得
+            if (u.id === currentSessionId) {
+                const avatarState = this.avatarController.getState();
+                return {
+                    id: u.id,
+                    name: u.profile?.displayName || u.id.split('#')[0] || u.id,
+                    isBot: false,
+                    position: avatarState?.position,
+                    rotation: avatarState?.rotation
+                        ? {
+                            x: (avatarState.rotation.x * 180) / Math.PI,
+                            y: (avatarState.rotation.y * 180) / Math.PI,
+                            z: (avatarState.rotation.z * 180) / Math.PI,
+                            w: 1, // 簡略化
+                        }
+                        : undefined,
+                };
+            }
+            // UserAvatarManagerからアバター情報を取得
+            const avatar = this.userAvatarManager.getUser(u.id);
+            return {
+                id: u.id,
+                name: u.profile?.displayName || u.id.split('#')[0] || u.id,
+                isBot: false,
+                position: avatar?.position,
+                rotation: avatar?.rotation,
+            };
+        });
+    }
+    getRateLimit(key) {
+        return this.rateLimiter.getRate(key);
+    }
+    setRateLimit(key, perSecond) {
+        this.rateLimiter.setRate(key, perSecond);
+    }
+    getSessionId() {
+        // 接続マネージャーからセッションIDを取得
+        return this.connectionManager.getSessionId();
+    }
+    // EventEmitterのメソッドをオーバーライド
+    on(event, listener) {
+        // EventEmitterは汎用的な型を期待するため、型変換が必要
+        // string型にキャストして、リスナーは関数型として扱う
+        return super.on(event, listener);
+    }
+    off(event, listener) {
+        // EventEmitterは汎用的な型を期待するため、型変換が必要
+        return super.off(event, listener);
+    }
+}
+/**
+ * MetatellClientのインスタンスを生成し、初期化します。
+ * @param options クライアント設定
+ * @returns MetatellClientのインスタンス
+ * @throws {MetatellError} 設定が不正な場合にスローされます。
+ */
+export function createMetatellClient(options) {
+    // 設定バリデーション
+    if (!options.serverUrl || !options.roomId) {
+        throw new MetatellError('INVALID_CONFIG', 'serverUrl and roomId are required');
+    }
+    // サブドメインを除いたサーバーURLを生成
+    const processedOptions = { ...options };
+    try {
+        const url = new URL(options.serverUrl.replace(/^ws/, 'http'));
+        const hostParts = url.hostname.split('.');
+        if (hostParts.length >= 2) {
+            // サブドメインがある場合は除去（例: urth.metatell.app -> metatell.app）
+            const mainDomain = hostParts.slice(-2).join('.');
+            processedOptions.serverUrl = options.serverUrl.replace(url.hostname, mainDomain);
+        }
+    }
+    catch (_error) {
+        // URL解析に失敗した場合はそのまま使用
+        // エラーログなどは出さず、元のURLを使用
+    }
+    return new MetatellClientImpl(processedOptions);
+}
+//# sourceMappingURL=client.js.map