@metatell/bot-sdk 0.0.1

package/dist/sdk/AgentClient.js

@@ -0,0 +1,404 @@
+/**
+ * Agent Client - facade for CLI/SDK usage
+ */
+import { EventEmitter } from 'node:events';
+// Realtime types will be defined locally to avoid circular dependencies
+import { AnimationNotFoundError, AnimationPlaybackError, AnimationService, AvatarController, AvatarNotSpawnedError, ConfigurationProvider, ConnectionManager, CoreServiceFactory, MessageService, UserAvatarManager, } from '@metatell/bot-core';
+import { getLogger } from './logging/index.js';
+import { RateLimitedQueue } from './rate.js';
+/**
+ * Default implementation using existing services
+ */
+export class DefaultAgentClient extends EventEmitter {
+    avatarController;
+    messageService;
+    userAvatarManager;
+    connectionManager;
+    animationService;
+    // Voice transport functionality moved to consuming packages
+    rateLimiter = new RateLimitedQueue();
+    logger = getLogger('AgentClient');
+    factory;
+    voiceMuted = false;
+    status = {
+        connected: false,
+        connecting: false,
+        retries: 0,
+    };
+    lastConnectionOptions;
+    configProvider;
+    constructor(factory, config = {}) {
+        super();
+        this.factory = factory;
+        // コアサービスインターフェースのみに依存（型推論で取得）
+        this.avatarController = factory.getService(AvatarController);
+        this.messageService = factory.getService(MessageService);
+        this.userAvatarManager = factory.getService(UserAvatarManager);
+        this.connectionManager = factory.getService(ConnectionManager);
+        this.configProvider = factory.getService(ConfigurationProvider);
+        // Optional services
+        try {
+            this.animationService = factory.getService(AnimationService);
+        }
+        catch {
+            // Animation service is optional
+            this.logger.debug('Animation service not available');
+        }
+        // Voice transport functionality moved to consuming packages
+        // Setup event handlers for user join
+        this.setupEventHandlers();
+        // レート制限の設定
+        if (config.rateLimit?.messages) {
+            this.rateLimiter.setRate('messages', config.rateLimit.messages);
+        }
+        if (config.rateLimit?.moves) {
+            this.rateLimiter.setRate('moves', config.rateLimit.moves);
+        }
+        if (config.rateLimit?.looks) {
+            this.rateLimiter.setRate('looks', config.rateLimit.looks);
+        }
+    }
+    async connect(options) {
+        this.logger.info('Connecting to server', options);
+        this.status.connecting = true;
+        // 接続オプションを保存
+        this.lastConnectionOptions = options;
+        try {
+            let serverUrl;
+            let hubId;
+            // Use provided values or parse from URL
+            if (options.serverUrl && options.hubId) {
+                serverUrl = options.serverUrl;
+                hubId = options.hubId;
+            }
+            else {
+                // URLを解析してserverUrlとhubIdを取得
+                const url = new URL(options.url);
+                // HTTPSからWSSに変換
+                const protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
+                const port = url.port ? `:${url.port}` : '';
+                serverUrl = `${protocol}//${url.hostname}${port}`;
+                // hubIdを取得（パスから'/'を除去）
+                const pathParts = url.pathname.split('/').filter(Boolean);
+                hubId = pathParts[0];
+                if (!hubId) {
+                    throw new Error('Invalid URL: hub ID not found');
+                }
+            }
+            // Connect through connection manager directly
+            await this.connectionManager.connect({
+                serverUrl,
+                hubId,
+            });
+            // セッションIDを取得
+            const sessionId = this.connectionManager.getSessionId();
+            this.status.sessionId = sessionId || undefined;
+            // ハブチャンネルが準備できるまで待機
+            let channel = this.connectionManager.getHubChannel();
+            let retries = 0;
+            while (!channel && retries < 50) {
+                // 最大5秒待機
+                await new Promise((resolve) => setTimeout(resolve, 100));
+                channel = this.connectionManager.getHubChannel();
+                retries++;
+            }
+            if (!channel) {
+                throw new Error('Failed to get hub channel after connection');
+            }
+            // Send room entry events
+            channel.push('events:entering', {});
+            channel.push('events:entered', {
+                initialOccupantCount: 0,
+                isNewDaily: true,
+                isNewMonthly: true,
+                isNewDayWindow: true,
+                isNewMonthWindow: true,
+                entryDisplayType: 'Bot',
+                userAgent: 'MetatellBot/1.0',
+            });
+            // Get avatar configuration and spawn
+            const configProvider = this.factory.getService(ConfigurationProvider);
+            const config = configProvider.getConfiguration();
+            if (config.profile.avatarId) {
+                this.logger.debug('Spawning avatar', {
+                    avatarId: config.profile.avatarId,
+                    organizationAvatarUrl: config.organizationAvatarUrl,
+                });
+                await this.avatarController.spawn(config.profile.avatarId, undefined, config.organizationAvatarUrl);
+            }
+            // Voice connection functionality moved to consuming packages
+            this.status.connected = true;
+            this.status.connecting = false;
+            this.logger.info('Connected successfully', {
+                serverUrl,
+                hubId,
+                sessionId: this.status.sessionId,
+                voiceEnabled: false, // Voice functionality moved to consuming packages
+            });
+        }
+        catch (error) {
+            this.status.connecting = false;
+            this.status.retries++;
+            this.logger.error('Connection failed', { error });
+            throw error;
+        }
+    }
+    async disconnect() {
+        this.logger.info('Disconnecting from server');
+        // Voice disconnection functionality moved to consuming packages
+        await this.connectionManager.disconnect();
+        this.status.connected = false;
+        this.status.room = undefined;
+        this.status.sessionId = undefined;
+    }
+    async join(room) {
+        this.logger.info('Joining room', { room });
+        // 既に接続されている場合は、一旦切断してから再接続
+        if (this.status.connected) {
+            await this.disconnect();
+        }
+        // 新しいroomに接続
+        const config = this.configProvider.getConfiguration();
+        const newUrl = config.hubUrl.replace(/\/[^/]+\/$/, `/${room}/`); // URLのroom部分を更新
+        if (this.lastConnectionOptions?.url) {
+            // URL形式の接続オプションを使用
+            await this.connect({
+                url: newUrl,
+                token: this.lastConnectionOptions.token,
+                voice: this.lastConnectionOptions.voice,
+            });
+        }
+        else if (this.lastConnectionOptions) {
+            // 個別パラメータ形式の接続オプションを使用
+            await this.connect({
+                ...this.lastConnectionOptions,
+                hubId: room,
+                hubUrl: newUrl,
+            });
+        }
+        else {
+            // 新規接続
+            await this.connect({
+                url: newUrl,
+            });
+        }
+        this.status.room = room;
+    }
+    async leave() {
+        this.logger.info('Leaving room');
+        if (this.status.connected) {
+            await this.disconnect();
+        }
+        this.status.room = undefined;
+    }
+    getStatus() {
+        return { ...this.status };
+    }
+    async send(message) {
+        return this.rateLimiter.execute('messages', async () => {
+            await this.messageService.sendMessage(message);
+        });
+    }
+    // Alias for send
+    async say(message) {
+        return this.send(message);
+    }
+    async move(position) {
+        return this.rateLimiter.execute('moves', async () => {
+            this.logger.debug('Moving avatar', position);
+            await this.avatarController.move(position);
+        });
+    }
+    async look(target) {
+        return this.rateLimiter.execute('looks', async () => {
+            if ('userId' in target) {
+                this.logger.debug('Looking at user', { userId: target.userId });
+                const user = this.userAvatarManager.getUser(target.userId);
+                if (!user) {
+                    throw new Error(`User not found: ${target.userId}`);
+                }
+                await this.lookAtPosition(user.position);
+            }
+            else {
+                this.logger.debug('Looking at position', target);
+                await this.lookAtPosition(target);
+            }
+        });
+    }
+    async lookAtNearest() {
+        return this.rateLimiter.execute('looks', async () => {
+            this.logger.debug('Looking at nearest user');
+            const currentState = this.avatarController.getState();
+            if (!currentState) {
+                throw new Error('Avatar not spawned');
+            }
+            const nearestUser = this.userAvatarManager.getNearestUser(currentState.position);
+            if (!nearestUser) {
+                throw new Error('No users found');
+            }
+            await this.lookAtPosition(nearestUser.position);
+        });
+    }
+    async lookAtPosition(target) {
+        const currentState = this.avatarController.getState();
+        if (!currentState) {
+            throw new Error('Avatar not spawned');
+        }
+        // 向く方向を計算（Y軸回転のみ）
+        const dx = target.x - currentState.position.x;
+        const dz = target.z - currentState.position.z;
+        const angle = Math.atan2(dx, dz);
+        // クォータニオンに変換（Y軸回転）
+        const rotation = {
+            x: 0,
+            y: Math.sin(angle / 2),
+            z: 0,
+            w: Math.cos(angle / 2),
+        };
+        await this.avatarController.rotate(rotation);
+    }
+    getUsers() {
+        return this.userAvatarManager.getUsers();
+    }
+    getUser(id) {
+        return this.userAvatarManager.getUser(id);
+    }
+    getUsersNearby(radius) {
+        const avatarState = this.avatarController.getState();
+        if (!avatarState)
+            return [];
+        return this.userAvatarManager.getUsersInRange(avatarState.position, radius);
+    }
+    on(event, handler) {
+        super.on(event, handler);
+        return this;
+    }
+    off(event, handler) {
+        super.off(event, handler);
+        return this;
+    }
+    // Override EventEmitter methods to return this for chaining
+    addListener(eventName, listener) {
+        super.addListener(eventName, listener);
+        return this;
+    }
+    removeListener(eventName, listener) {
+        super.removeListener(eventName, listener);
+        return this;
+    }
+    setRateLimit(key, perSecond) {
+        this.rateLimiter.setRate(key, perSecond);
+    }
+    getRateLimit(key) {
+        return this.rateLimiter.getRate(key);
+    }
+    /**
+     * Play animation on avatar
+     */
+    async playAnimation(animationId, options) {
+        try {
+            const result = await this.avatarController.playAnimation(animationId, options);
+            this.logger.info('Animation played', {
+                animationId,
+                playbackId: result.playbackId,
+            });
+            return result;
+        }
+        catch (error) {
+            // Convert to specific error types
+            if (error instanceof AvatarNotSpawnedError) {
+                throw error;
+            }
+            if (error instanceof AnimationNotFoundError) {
+                throw error;
+            }
+            throw new AnimationPlaybackError(`Failed to play animation: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Stop current animation
+     */
+    async stopAnimation() {
+        await this.avatarController.stopAnimation();
+        this.logger.debug('Animation stopped');
+    }
+    /**
+     * Get available animations
+     */
+    async getAvailableAnimations() {
+        if (!this.animationService) {
+            // Return empty array if animation service not available
+            this.logger.warn('Animation service not available');
+            return [];
+        }
+        const config = this.factory.getService(ConfigurationProvider);
+        const avatarId = config.getConfiguration().profile.avatarId;
+        if (!avatarId) {
+            this.logger.warn('No avatar ID configured');
+            return [];
+        }
+        try {
+            return await this.animationService.getAvailableAnimations(avatarId);
+        }
+        catch (error) {
+            this.logger.error('Failed to get available animations', { error });
+            return [];
+        }
+    }
+    /**
+     * Get current animation
+     */
+    getCurrentAnimation() {
+        return this.avatarController.getCurrentAnimation();
+    }
+    /**
+     * Send voice frame (stub - implementation moved to consuming packages)
+     */
+    async sendVoiceFrame(_pcmData) {
+        throw new Error('Voice functionality not available in SDK core - use consuming package implementation');
+    }
+    /**
+     * Mute/unmute voice (stub - implementation moved to consuming packages)
+     */
+    async muteVoice(muted) {
+        this.voiceMuted = muted;
+        this.logger.debug(`Voice ${muted ? 'muted' : 'unmuted'} - functionality moved to consuming packages`);
+    }
+    /**
+     * Check if voice is muted
+     */
+    isVoiceMuted() {
+        return this.voiceMuted;
+    }
+    // Voice connection functionality moved to consuming packages
+    setupEventHandlers() {
+        // Listen for user join events to resync avatar
+        this.userAvatarManager.on('userJoined', async (user) => {
+            // Resync avatar for new users so they can see the bot
+            const currentState = this.avatarController.getState();
+            if (currentState) {
+                try {
+                    await this.avatarController.resyncAvatar();
+                    this.logger.debug(`Resynced avatar for new user: ${user.nickname}`);
+                }
+                catch (error) {
+                    this.logger.error('Failed to resync avatar:', { error, user: user.nickname });
+                }
+            }
+        });
+    }
+}
+/**
+ * Factory function to create agent client
+ */
+export function createAgentClient(config, clientConfig) {
+    const factory = new CoreServiceFactory(config);
+    return new DefaultAgentClient(factory, clientConfig);
+}
+/**
+ * Factory function to create agent client with existing factory
+ */
+export function createAgentClientWithFactory(factory, clientConfig) {
+    return new DefaultAgentClient(factory, clientConfig);
+}
+//# sourceMappingURL=AgentClient.js.map

package/dist/sdk/AgentClient.js.map

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

package/dist/sdk/errors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * SDK error definitions
+ */
+export declare abstract class MetatellError extends Error {
+    abstract readonly code: string;
+    readonly timestamp: Date;
+    constructor(message: string);
+}
+export declare class AuthenticationError extends MetatellError {
+    readonly status?: number | undefined;
+    readonly code = "AUTH_ERROR";
+    constructor(message: string, status?: number | undefined);
+}
+export declare class RateLimitedError extends MetatellError {
+    readonly retryAfterMs?: number | undefined;
+    readonly code = "RATE_LIMITED";
+    constructor(message: string, retryAfterMs?: number | undefined);
+}
+export declare class TransportError extends MetatellError {
+    readonly reason?: string | undefined;
+    readonly code = "TRANSPORT_ERROR";
+    constructor(message: string, reason?: string | undefined);
+}
+export declare class ProtocolError extends MetatellError {
+    readonly data?: unknown | undefined;
+    readonly code = "PROTOCOL_ERROR";
+    constructor(message: string, data?: unknown | undefined);
+}
+export declare class TimeoutError extends MetatellError {
+    readonly timeoutMs: number;
+    readonly code = "TIMEOUT_ERROR";
+    constructor(message: string, timeoutMs: number);
+}
+export declare function isMetatellError(error: unknown): error is MetatellError;
+export declare function isRetryableError(error: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/sdk/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/sdk/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8BAAsB,aAAc,SAAQ,KAAK;IAC/C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,OAAa;gBAEnB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,aAAa;aAKlC,MAAM,CAAC,EAAE,MAAM;IAJjC,QAAQ,CAAC,IAAI,gBAAe;gBAG1B,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA;CAIlC;AAED,qBAAa,gBAAiB,SAAQ,aAAa;aAK/B,YAAY,CAAC,EAAE,MAAM;IAJvC,QAAQ,CAAC,IAAI,kBAAiB;gBAG5B,OAAO,EAAE,MAAM,EACC,YAAY,CAAC,EAAE,MAAM,YAAA;CAIxC;AAED,qBAAa,cAAe,SAAQ,aAAa;aAK7B,MAAM,CAAC,EAAE,MAAM;IAJjC,QAAQ,CAAC,IAAI,qBAAoB;gBAG/B,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA;CAIlC;AAED,qBAAa,aAAc,SAAQ,aAAa;aAK5B,IAAI,CAAC,EAAE,OAAO;IAJhC,QAAQ,CAAC,IAAI,oBAAmB;gBAG9B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,OAAO,YAAA;CAIjC;AAED,qBAAa,YAAa,SAAQ,aAAa;aAK3B,SAAS,EAAE,MAAM;IAJnC,QAAQ,CAAC,IAAI,mBAAkB;gBAG7B,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,MAAM;CAIpC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQxD"}

package/dist/sdk/errors.js

@@ -0,0 +1,61 @@
+/**
+ * SDK error definitions
+ */
+export class MetatellError extends Error {
+    timestamp = new Date();
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+    }
+}
+export class AuthenticationError extends MetatellError {
+    status;
+    code = 'AUTH_ERROR';
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+    }
+}
+export class RateLimitedError extends MetatellError {
+    retryAfterMs;
+    code = 'RATE_LIMITED';
+    constructor(message, retryAfterMs) {
+        super(message);
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+export class TransportError extends MetatellError {
+    reason;
+    code = 'TRANSPORT_ERROR';
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+    }
+}
+export class ProtocolError extends MetatellError {
+    data;
+    code = 'PROTOCOL_ERROR';
+    constructor(message, data) {
+        super(message);
+        this.data = data;
+    }
+}
+export class TimeoutError extends MetatellError {
+    timeoutMs;
+    code = 'TIMEOUT_ERROR';
+    constructor(message, timeoutMs) {
+        super(message);
+        this.timeoutMs = timeoutMs;
+    }
+}
+export function isMetatellError(error) {
+    return error instanceof MetatellError;
+}
+export function isRetryableError(error) {
+    if (!isMetatellError(error))
+        return false;
+    return (error instanceof TransportError ||
+        error instanceof TimeoutError ||
+        (error instanceof RateLimitedError && error.retryAfterMs !== undefined));
+}
+//# sourceMappingURL=errors.js.map

package/dist/sdk/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/sdk/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAgB,aAAc,SAAQ,KAAK;IAEtC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAA;IAE/B,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;IACnC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IAKlC;IAJT,IAAI,GAAG,YAAY,CAAA;IAE5B,YACE,OAAe,EACC,MAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,WAAM,GAAN,MAAM,CAAS;IAGjC,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IAK/B;IAJT,IAAI,GAAG,cAAc,CAAA;IAE9B,YACE,OAAe,EACC,YAAqB;QAErC,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,iBAAY,GAAZ,YAAY,CAAS;IAGvC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,aAAa;IAK7B;IAJT,IAAI,GAAG,iBAAiB,CAAA;IAEjC,YACE,OAAe,EACC,MAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,WAAM,GAAN,MAAM,CAAS;IAGjC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,aAAa;IAK5B;IAJT,IAAI,GAAG,gBAAgB,CAAA;IAEhC,YACE,OAAe,EACC,IAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,SAAI,GAAJ,IAAI,CAAU;IAGhC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,aAAa;IAK3B;IAJT,IAAI,GAAG,eAAe,CAAA;IAE/B,YACE,OAAe,EACC,SAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,cAAS,GAAT,SAAS,CAAQ;IAGnC,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,aAAa,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAEzC,OAAO,CACL,KAAK,YAAY,cAAc;QAC/B,KAAK,YAAY,YAAY;QAC7B,CAAC,KAAK,YAAY,gBAAgB,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CACxE,CAAA;AACH,CAAC"}

package/dist/sdk/logging/LogEventEmitter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Event emitter for log-related events
+ * Provides reactive log updates to consumers
+ */
+import type { CoreLogRecord } from './index.js';
+export type LogEventHandler = (records: CoreLogRecord[]) => void;
+export interface ILogEventEmitter {
+    /**
+     * Subscribe to new log events
+     */
+    onNewLogs(handler: LogEventHandler): () => void;
+    /**
+     * Emit new log records
+     */
+    emitNewLogs(records: CoreLogRecord[]): void;
+    /**
+     * Remove all log event listeners
+     */
+    removeAllListeners(): void;
+}
+/**
+ * Implementation of log event emitter
+ */
+export declare class LogEventEmitter implements ILogEventEmitter {
+    private handlers;
+    onNewLogs(handler: LogEventHandler): () => void;
+    emitNewLogs(records: CoreLogRecord[]): void;
+    removeAllListeners(): void;
+}
+/**
+ * Get the global log event emitter
+ */
+export declare function getLogEventEmitter(): ILogEventEmitter;
+/**
+ * Reset the log event emitter (mainly for testing)
+ */
+export declare function resetLogEventEmitter(): void;
+//# sourceMappingURL=LogEventEmitter.d.ts.map

package/dist/sdk/logging/LogEventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogEventEmitter.d.ts","sourceRoot":"","sources":["../../../src/sdk/logging/LogEventEmitter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,IAAI,CAAA;AAEhE,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,IAAI,CAAA;IAE/C;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI,CAAA;IAE3C;;OAEG;IACH,kBAAkB,IAAI,IAAI,CAAA;CAC3B;AAED;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,QAAQ,CAAkC;IAElD,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,IAAI;IAS/C,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI;IAa3C,kBAAkB,IAAI,IAAI;CAG3B;AAKD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,gBAAgB,CAKrD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C"}

package/dist/sdk/logging/LogEventEmitter.js

@@ -0,0 +1,54 @@
+/**
+ * Event emitter for log-related events
+ * Provides reactive log updates to consumers
+ */
+/**
+ * Implementation of log event emitter
+ */
+export class LogEventEmitter {
+    handlers = new Set();
+    onNewLogs(handler) {
+        this.handlers.add(handler);
+        // Return unsubscribe function
+        return () => {
+            this.handlers.delete(handler);
+        };
+    }
+    emitNewLogs(records) {
+        if (records.length === 0)
+            return;
+        // Notify all handlers
+        for (const handler of this.handlers) {
+            try {
+                handler(records);
+            }
+            catch (error) {
+                console.error('Error in log event handler:', error);
+            }
+        }
+    }
+    removeAllListeners() {
+        this.handlers.clear();
+    }
+}
+// Global singleton instance
+let globalLogEventEmitter = null;
+/**
+ * Get the global log event emitter
+ */
+export function getLogEventEmitter() {
+    if (!globalLogEventEmitter) {
+        globalLogEventEmitter = new LogEventEmitter();
+    }
+    return globalLogEventEmitter;
+}
+/**
+ * Reset the log event emitter (mainly for testing)
+ */
+export function resetLogEventEmitter() {
+    if (globalLogEventEmitter) {
+        globalLogEventEmitter.removeAllListeners();
+    }
+    globalLogEventEmitter = null;
+}
+//# sourceMappingURL=LogEventEmitter.js.map

package/dist/sdk/logging/LogEventEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogEventEmitter.js","sourceRoot":"","sources":["../../../src/sdk/logging/LogEventEmitter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,QAAQ,GAAyB,IAAI,GAAG,EAAE,CAAA;IAElD,SAAS,CAAC,OAAwB;QAChC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAE1B,8BAA8B;QAC9B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAC/B,CAAC,CAAA;IACH,CAAC;IAED,WAAW,CAAC,OAAwB;QAClC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAEhC,sBAAsB;QACtB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,OAAO,CAAC,OAAO,CAAC,CAAA;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAA;YACrD,CAAC;QACH,CAAC;IACH,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;IACvB,CAAC;CACF;AAED,4BAA4B;AAC5B,IAAI,qBAAqB,GAA4B,IAAI,CAAA;AAEzD;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC3B,qBAAqB,GAAG,IAAI,eAAe,EAAE,CAAA;IAC/C,CAAC;IACD,OAAO,qBAAqB,CAAA;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,qBAAqB,EAAE,CAAC;QAC1B,qBAAqB,CAAC,kBAAkB,EAAE,CAAA;IAC5C,CAAC;IACD,qBAAqB,GAAG,IAAI,CAAA;AAC9B,CAAC"}

package/dist/sdk/logging/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * SDK Logging module - SPI and default implementation
+ */
+export { getLogEventEmitter, type ILogEventEmitter, type LogEventHandler, resetLogEventEmitter, } from './LogEventEmitter.js';
+export { DefaultLoggerProvider, getRingBuffer } from './providers/default.js';
+export * from './spi.js';
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogRecord {
+    ts: number;
+    level: LogLevel;
+    module: string;
+    msg: string;
+    meta?: unknown;
+}
+export interface RingBufferLike {
+    drain(): LogRecord[];
+    drainNew?(): LogRecord[];
+    clear(): void;
+    size(): number;
+}
+export type { LogRecord as CoreLogRecord };
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/logging/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,oBAAoB,GACrB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE7E,cAAc,UAAU,CAAA;AAGxB,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,QAAQ,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAGD,MAAM,WAAW,cAAc;IAC7B,KAAK,IAAI,SAAS,EAAE,CAAA;IACpB,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAA;IACxB,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,MAAM,CAAA;CACf;AAGD,YAAY,EAAE,SAAS,IAAI,aAAa,EAAE,CAAA"}