@egain/ai-agent-sdk 0.1.0

package/dist/core/connection/Transport.js

@@ -0,0 +1,27 @@
+import { EventEmitter } from '../events/EventEmitter.js';
+import { globalLogger } from '../logging/globalLogger.js';
+/**
+ * Abstract base class for transport implementations.
+ *
+ * Any transport mechanism (WebSocket, SSE, HTTP polling, etc.) should extend
+ * this class and implement the abstract methods.
+ *
+ * @example
+ * ```typescript
+ * class MyCustomTransport extends Transport {
+ *   async connect(): Promise<void> { ... }
+ *   disconnect(): void { ... }
+ *   async send(data: any): Promise<void> { ... }
+ *   isConnected(): boolean { ... }
+ * }
+ * ```
+ */
+export class Transport extends EventEmitter {
+    constructor(config) {
+        super();
+        this.endpoint = config.endpoint;
+        this.connectionTimeout = config.connectionTimeout ?? 10000;
+        this.logger = config.logger ?? globalLogger;
+    }
+}
+//# sourceMappingURL=Transport.js.map

package/dist/core/connection/Transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transport.js","sourceRoot":"","sources":["../../../src/core/connection/Transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAiD1D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAgB,SAAU,SAAQ,YAA6B;IAKnE,YAAY,MAAuB;QACjC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,IAAI,KAAK,CAAC;QAC3D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,YAAY,CAAC;IAC9C,CAAC;CA2BF"}

package/dist/core/connection/WebSocketTransport.d.ts

@@ -0,0 +1,65 @@
+import { Transport, TransportConfig } from './Transport.js';
+/**
+ * WebSocket transport configuration
+ */
+export interface WebSocketTransportConfig extends TransportConfig {
+    /**
+     * WebSocket protocols (optional)
+     */
+    protocols?: string | string[];
+}
+/**
+ * WebSocket-based transport implementation.
+ *
+ * This transport uses the native WebSocket API to establish
+ * bidirectional communication with the server.
+ *
+ * @example
+ * ```typescript
+ * const transport = new WebSocketTransport({
+ *   endpoint: 'wss://api.example.com/ws'
+ * });
+ *
+ * transport.on('message', ({ data }) => {
+ *   console.log('Received:', data);
+ * });
+ *
+ * await transport.connect();
+ * await transport.send({ text: 'Hello' });
+ * ```
+ */
+export declare class WebSocketTransport extends Transport {
+    private ws;
+    private connectTimeoutTimer;
+    private protocols?;
+    constructor(config: WebSocketTransportConfig);
+    /**
+     * Get the transport type identifier
+     */
+    getType(): string;
+    /**
+     * Check if the WebSocket is currently connected
+     */
+    isConnected(): boolean;
+    /**
+     * Establish the WebSocket connection
+     */
+    connect(): Promise<void>;
+    /**
+     * Close the WebSocket connection
+     */
+    disconnect(): void;
+    /**
+     * Send data through the WebSocket
+     */
+    send(data: any): Promise<void>;
+    /**
+     * Handle incoming WebSocket message
+     */
+    private handleMessage;
+    /**
+     * Clear connection timeout timer
+     */
+    private clearConnectTimeout;
+}
+//# sourceMappingURL=WebSocketTransport.d.ts.map

package/dist/core/connection/WebSocketTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketTransport.d.ts","sourceRoot":"","sources":["../../../src/core/connection/WebSocketTransport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAG5D;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,mBAAmB,CAA8C;IACzE,OAAO,CAAC,SAAS,CAAC,CAAoB;gBAE1B,MAAM,EAAE,wBAAwB;IAK5C;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyE9B;;OAEG;IACH,UAAU,IAAI,IAAI;IAUlB;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBpC;;OAEG;IACH,OAAO,CAAC,aAAa;IAyBrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAM5B"}

package/dist/core/connection/WebSocketTransport.js

@@ -0,0 +1,177 @@
+import { Transport } from './Transport.js';
+import { ConnectionError } from '../errors/SDKError.js';
+/**
+ * WebSocket-based transport implementation.
+ *
+ * This transport uses the native WebSocket API to establish
+ * bidirectional communication with the server.
+ *
+ * @example
+ * ```typescript
+ * const transport = new WebSocketTransport({
+ *   endpoint: 'wss://api.example.com/ws'
+ * });
+ *
+ * transport.on('message', ({ data }) => {
+ *   console.log('Received:', data);
+ * });
+ *
+ * await transport.connect();
+ * await transport.send({ text: 'Hello' });
+ * ```
+ */
+export class WebSocketTransport extends Transport {
+    constructor(config) {
+        super(config);
+        this.ws = null;
+        this.connectTimeoutTimer = null;
+        this.protocols = config.protocols;
+    }
+    /**
+     * Get the transport type identifier
+     */
+    getType() {
+        return 'websocket';
+    }
+    /**
+     * Check if the WebSocket is currently connected
+     */
+    isConnected() {
+        return this.ws !== null && this.ws.readyState === WebSocket.OPEN;
+    }
+    /**
+     * Establish the WebSocket connection
+     */
+    async connect() {
+        if (this.isConnected()) {
+            this.logger.debug('WebSocket already connected', { endpoint: this.endpoint });
+            return;
+        }
+        this.logger.debug('Connecting WebSocket', { endpoint: this.endpoint, protocols: this.protocols });
+        return new Promise((resolve, reject) => {
+            try {
+                // Create WebSocket connection
+                this.ws = new WebSocket(this.endpoint, this.protocols);
+                // Set connection timeout
+                this.connectTimeoutTimer = setTimeout(() => {
+                    if (this.ws && this.ws.readyState !== WebSocket.OPEN) {
+                        this.ws.close();
+                        const error = new ConnectionError('Connection timeout');
+                        this.logger.error('WebSocket connection timeout', error, { endpoint: this.endpoint });
+                        this.emit('error', { error, timestamp: Date.now() });
+                        reject(error);
+                    }
+                }, this.connectionTimeout);
+                // Handle successful connection
+                this.ws.onopen = () => {
+                    this.clearConnectTimeout();
+                    this.logger.info('WebSocket connected', { endpoint: this.endpoint });
+                    this.emit('connected', { timestamp: Date.now() });
+                    resolve();
+                };
+                // Handle incoming messages
+                this.ws.onmessage = (event) => {
+                    this.handleMessage(event);
+                };
+                // Handle errors
+                this.ws.onerror = (event) => {
+                    const error = new ConnectionError('WebSocket error');
+                    this.logger.error('WebSocket error', error, { endpoint: this.endpoint });
+                    this.emit('error', { error, timestamp: Date.now() });
+                };
+                // Handle connection close
+                this.ws.onclose = (event) => {
+                    this.clearConnectTimeout();
+                    this.ws = null;
+                    this.logger.info('WebSocket closed', {
+                        endpoint: this.endpoint,
+                        code: event.code,
+                        reason: event.reason
+                    });
+                    this.emit('closed', {
+                        code: event.code,
+                        reason: event.reason,
+                        timestamp: Date.now(),
+                    });
+                };
+            }
+            catch (error) {
+                this.clearConnectTimeout();
+                const connError = new ConnectionError('Failed to establish WebSocket connection', error instanceof Error ? error : new Error(String(error)));
+                this.logger.error('Failed to establish WebSocket connection', connError, { endpoint: this.endpoint });
+                this.emit('error', { error: connError, timestamp: Date.now() });
+                reject(connError);
+            }
+        });
+    }
+    /**
+     * Close the WebSocket connection
+     */
+    disconnect() {
+        this.clearConnectTimeout();
+        if (this.ws) {
+            this.logger.debug('Disconnecting WebSocket', { endpoint: this.endpoint });
+            this.ws.close(1000, 'Client disconnect');
+            this.ws = null;
+        }
+    }
+    /**
+     * Send data through the WebSocket
+     */
+    async send(data) {
+        if (!this.isConnected() || !this.ws) {
+            const error = new ConnectionError('Cannot send message: not connected');
+            this.logger.warn('Cannot send message: WebSocket not connected', { endpoint: this.endpoint });
+            throw error;
+        }
+        try {
+            const message = typeof data === 'string' ? data : JSON.stringify(data);
+            this.logger.debug('Sending WebSocket message', { endpoint: this.endpoint, messageLength: message.length });
+            this.ws.send(message);
+        }
+        catch (error) {
+            const connError = new ConnectionError('Failed to send message', error instanceof Error ? error : new Error(String(error)));
+            this.logger.error('Failed to send WebSocket message', connError, { endpoint: this.endpoint });
+            throw connError;
+        }
+    }
+    /**
+     * Handle incoming WebSocket message
+     */
+    handleMessage(event) {
+        try {
+            let data;
+            if (typeof event.data === 'string') {
+                try {
+                    data = JSON.parse(event.data);
+                }
+                catch {
+                    data = event.data;
+                }
+            }
+            else {
+                data = event.data;
+            }
+            this.logger.debug('WebSocket message received', { endpoint: this.endpoint, dataType: typeof data });
+            this.emit('message', { data, timestamp: Date.now() });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.logger.error('Failed to handle WebSocket message', err, { endpoint: this.endpoint });
+            this.emit('error', {
+                error: err,
+                timestamp: Date.now(),
+            });
+        }
+    }
+    /**
+     * Clear connection timeout timer
+     */
+    clearConnectTimeout() {
+        if (this.connectTimeoutTimer) {
+            clearTimeout(this.connectTimeoutTimer);
+            this.connectTimeoutTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=WebSocketTransport.js.map

package/dist/core/connection/WebSocketTransport.js.map

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

package/dist/core/errors/SDKError.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Base error class for all SDK errors
+ */
+export declare class SDKError extends Error {
+    readonly code?: string | undefined;
+    readonly cause?: Error | undefined;
+    constructor(message: string, code?: string | undefined, cause?: Error | undefined);
+}
+/**
+ * Authentication-related errors
+ */
+export declare class AuthError extends SDKError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Connection-related errors
+ */
+export declare class ConnectionError extends SDKError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Message-related errors
+ */
+export declare class MessageError extends SDKError {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=SDKError.d.ts.map

package/dist/core/errors/SDKError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SDKError.d.ts","sourceRoot":"","sources":["../../../src/core/errors/SDKError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAGf,IAAI,CAAC;aACL,KAAK,CAAC;gBAFtB,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,oBAAQ,EACb,KAAK,CAAC,mBAAO;CAMhC;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,QAAQ;gBACzB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK3C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK3C;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK3C"}

package/dist/core/errors/SDKError.js

@@ -0,0 +1,43 @@
+/**
+ * Base error class for all SDK errors
+ */
+export class SDKError extends Error {
+    constructor(message, code, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'SDKError';
+        Object.setPrototypeOf(this, SDKError.prototype);
+    }
+}
+/**
+ * Authentication-related errors
+ */
+export class AuthError extends SDKError {
+    constructor(message, cause) {
+        super(message, 'AUTH_ERROR', cause);
+        this.name = 'AuthError';
+        Object.setPrototypeOf(this, AuthError.prototype);
+    }
+}
+/**
+ * Connection-related errors
+ */
+export class ConnectionError extends SDKError {
+    constructor(message, cause) {
+        super(message, 'CONNECTION_ERROR', cause);
+        this.name = 'ConnectionError';
+        Object.setPrototypeOf(this, ConnectionError.prototype);
+    }
+}
+/**
+ * Message-related errors
+ */
+export class MessageError extends SDKError {
+    constructor(message, cause) {
+        super(message, 'MESSAGE_ERROR', cause);
+        this.name = 'MessageError';
+        Object.setPrototypeOf(this, MessageError.prototype);
+    }
+}
+//# sourceMappingURL=SDKError.js.map

package/dist/core/errors/SDKError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SDKError.js","sourceRoot":"","sources":["../../../src/core/errors/SDKError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YACE,OAAe,EACC,IAAa,EACb,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAS;QACb,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,QAAQ;IACrC,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/core/events/EventEmitter.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Handler function for events.
+ * Can be synchronous or return a Promise for async handling.
+ * @typeParam T - The event data type
+ */
+type EventHandler<T = any> = (data: T) => void | Promise<void>;
+/**
+ * Map of event names to their data types.
+ */
+type EventMap = Record<string, any>;
+/**
+ * Type-safe event emitter implementation.
+ *
+ * Compatible with both browser and Node.js environments.
+ * Provides a foundation for event-driven communication throughout the SDK.
+ *
+ * @typeParam T - Event map defining event names and their data types
+ *
+ * @example Creating a custom event emitter
+ * ```typescript
+ * import { EventEmitter } from "@eGain/ai-agent-sdk";
+ *
+ * interface MyEvents {
+ *   data: { value: number };
+ *   error: { message: string };
+ * }
+ *
+ * class MyService extends EventEmitter<MyEvents> {
+ *   doSomething() {
+ *     this.emit("data", { value: 42 });
+ *   }
+ * }
+ *
+ * const service = new MyService();
+ * service.on("data", (event) => {
+ *   console.log(event.value); // Typed as number
+ * });
+ * ```
+ *
+ * @category Events
+ */
+export declare class EventEmitter<T extends EventMap = EventMap> {
+    private handlers;
+    private onceHandlers;
+    /**
+     * Register an event handler.
+     *
+     * The handler will be called every time the event is emitted.
+     *
+     * @param event - The event name to listen for
+     * @param handler - The function to call when the event is emitted
+     * @returns `this` for method chaining
+     *
+     * @example
+     * ```typescript
+     * agent.on("message", (event) => {
+     *   console.log("Received:", event.payload);
+     * });
+     * ```
+     */
+    on<K extends keyof T>(event: K, handler: EventHandler<T[K]>): this;
+    /**
+     * Register a one-time event handler.
+     *
+     * The handler will be called only once, then automatically removed.
+     *
+     * @param event - The event name to listen for
+     * @param handler - The function to call when the event is emitted
+     * @returns `this` for method chaining
+     *
+     * @example
+     * ```typescript
+     * agent.once("connected", () => {
+     *   console.log("First connection established!");
+     * });
+     * ```
+     */
+    once<K extends keyof T>(event: K, handler: EventHandler<T[K]>): this;
+    /**
+     * Remove an event handler.
+     *
+     * If no handler is specified, removes all handlers for the event.
+     *
+     * @param event - The event name
+     * @param handler - The specific handler to remove (optional)
+     * @returns `this` for method chaining
+     *
+     * @example Remove specific handler
+     * ```typescript
+     * const handler = (event) => console.log(event);
+     * agent.on("message", handler);
+     * agent.off("message", handler);
+     * ```
+     *
+     * @example Remove all handlers
+     * ```typescript
+     * agent.off("message");
+     * ```
+     */
+    off<K extends keyof T>(event: K, handler?: EventHandler<T[K]>): this;
+    /**
+     * Emit an event
+     * Handlers are protected from exceptions - errors are caught and logged
+     */
+    protected emit<K extends keyof T>(event: K, data: T[K]): boolean;
+    /**
+     * Safely execute a handler, catching any exceptions
+     */
+    private safeEmit;
+    /**
+     * Remove all event handlers
+     */
+    removeAllListeners<K extends keyof T>(event?: K): this;
+    /**
+     * Get the number of listeners for an event
+     */
+    listenerCount<K extends keyof T>(event: K): number;
+}
+export {};
+//# sourceMappingURL=EventEmitter.d.ts.map

package/dist/core/events/EventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../../src/core/events/EventEmitter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,KAAK,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/D;;GAEG;AACH,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;IACrD,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,YAAY,CAA8C;IAElE;;;;;;;;;;;;;;;OAeG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAQlE;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAQpE;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAYpE;;;OAGG;IACH,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;IAyBhE;;OAEG;IACH,OAAO,CAAC,QAAQ;IAgBhB;;OAEG;IACH,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAWtD;;OAEG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;CAKnD"}

package/dist/core/events/EventEmitter.js

@@ -0,0 +1,183 @@
+/**
+ * Type-safe event emitter implementation.
+ *
+ * Compatible with both browser and Node.js environments.
+ * Provides a foundation for event-driven communication throughout the SDK.
+ *
+ * @typeParam T - Event map defining event names and their data types
+ *
+ * @example Creating a custom event emitter
+ * ```typescript
+ * import { EventEmitter } from "@eGain/ai-agent-sdk";
+ *
+ * interface MyEvents {
+ *   data: { value: number };
+ *   error: { message: string };
+ * }
+ *
+ * class MyService extends EventEmitter<MyEvents> {
+ *   doSomething() {
+ *     this.emit("data", { value: 42 });
+ *   }
+ * }
+ *
+ * const service = new MyService();
+ * service.on("data", (event) => {
+ *   console.log(event.value); // Typed as number
+ * });
+ * ```
+ *
+ * @category Events
+ */
+export class EventEmitter {
+    constructor() {
+        this.handlers = new Map();
+        this.onceHandlers = new Map();
+    }
+    /**
+     * Register an event handler.
+     *
+     * The handler will be called every time the event is emitted.
+     *
+     * @param event - The event name to listen for
+     * @param handler - The function to call when the event is emitted
+     * @returns `this` for method chaining
+     *
+     * @example
+     * ```typescript
+     * agent.on("message", (event) => {
+     *   console.log("Received:", event.payload);
+     * });
+     * ```
+     */
+    on(event, handler) {
+        if (!this.handlers.has(event)) {
+            this.handlers.set(event, new Set());
+        }
+        this.handlers.get(event).add(handler);
+        return this;
+    }
+    /**
+     * Register a one-time event handler.
+     *
+     * The handler will be called only once, then automatically removed.
+     *
+     * @param event - The event name to listen for
+     * @param handler - The function to call when the event is emitted
+     * @returns `this` for method chaining
+     *
+     * @example
+     * ```typescript
+     * agent.once("connected", () => {
+     *   console.log("First connection established!");
+     * });
+     * ```
+     */
+    once(event, handler) {
+        if (!this.onceHandlers.has(event)) {
+            this.onceHandlers.set(event, new Set());
+        }
+        this.onceHandlers.get(event).add(handler);
+        return this;
+    }
+    /**
+     * Remove an event handler.
+     *
+     * If no handler is specified, removes all handlers for the event.
+     *
+     * @param event - The event name
+     * @param handler - The specific handler to remove (optional)
+     * @returns `this` for method chaining
+     *
+     * @example Remove specific handler
+     * ```typescript
+     * const handler = (event) => console.log(event);
+     * agent.on("message", handler);
+     * agent.off("message", handler);
+     * ```
+     *
+     * @example Remove all handlers
+     * ```typescript
+     * agent.off("message");
+     * ```
+     */
+    off(event, handler) {
+        if (handler) {
+            this.handlers.get(event)?.delete(handler);
+            this.onceHandlers.get(event)?.delete(handler);
+        }
+        else {
+            // Remove all handlers for this event
+            this.handlers.delete(event);
+            this.onceHandlers.delete(event);
+        }
+        return this;
+    }
+    /**
+     * Emit an event
+     * Handlers are protected from exceptions - errors are caught and logged
+     */
+    emit(event, data) {
+        let hasHandlers = false;
+        // Execute regular handlers
+        const regularHandlers = this.handlers.get(event);
+        if (regularHandlers) {
+            hasHandlers = true;
+            for (const handler of regularHandlers) {
+                this.safeEmit(handler, data);
+            }
+        }
+        // Execute once handlers and remove them
+        const onceHandlers = this.onceHandlers.get(event);
+        if (onceHandlers) {
+            hasHandlers = true;
+            for (const handler of onceHandlers) {
+                this.safeEmit(handler, data);
+            }
+            onceHandlers.clear();
+        }
+        return hasHandlers;
+    }
+    /**
+     * Safely execute a handler, catching any exceptions
+     */
+    safeEmit(handler, data) {
+        try {
+            const result = handler(data);
+            // Handle async handlers
+            if (result instanceof Promise) {
+                result.catch((error) => {
+                    // Silently catch async errors to prevent SDK crashes
+                    // In production, this could be logged to an error reporting service
+                });
+            }
+        }
+        catch (error) {
+            // Silently catch sync errors to prevent SDK crashes
+            // In production, this could be logged to an error reporting service
+        }
+    }
+    /**
+     * Remove all event handlers
+     */
+    removeAllListeners(event) {
+        if (event) {
+            this.handlers.delete(event);
+            this.onceHandlers.delete(event);
+        }
+        else {
+            this.handlers.clear();
+            this.onceHandlers.clear();
+        }
+        return this;
+    }
+    /**
+     * Get the number of listeners for an event
+     */
+    listenerCount(event) {
+        const regular = this.handlers.get(event)?.size ?? 0;
+        const once = this.onceHandlers.get(event)?.size ?? 0;
+        return regular + once;
+    }
+}
+//# sourceMappingURL=EventEmitter.js.map