@egain/ai-agent-sdk 0.1.0

package/dist/core/message/BaseMessageHandler.d.ts

@@ -0,0 +1,208 @@
+/**
+ * # Custom Message Handlers
+ *
+ * Message handlers process incoming messages from the AI Agent server.
+ * You can create custom handlers to implement specialized message processing,
+ * custom business logic, or integration with other systems.
+ *
+ * ## Overview
+ *
+ * The SDK uses a chain of message handlers to process incoming messages.
+ * Each handler can:
+ * - Decide if it can handle a specific message type
+ * - Process the message and return a result
+ * - Pass the message to the next handler in the chain
+ *
+ * ## Built-in Handlers
+ *
+ * The SDK includes these handlers by default:
+ * - `AgentMessageHandler` - Processes agent responses
+ * - `HeartbeatHandler` - Handles typing indicators
+ * - `ErrorMessageHandler` - Handles error messages
+ * - `TokenRefreshHandler` - Handles token refresh requests
+ * - `ChatHistoryHandler` - Processes chat history messages
+ *
+ * ## Creating a Custom Handler
+ *
+ * Extend `BaseMessageHandler` to create your own:
+ *
+ * ```typescript
+ * import { BaseMessageHandler, Message, MessageHandlerResult } from "@eGain/ai-agent-sdk";
+ *
+ * class CustomHandler extends BaseMessageHandler {
+ *   canHandle(message: Message): boolean {
+ *     // Return true if this handler should process the message
+ *     return message.role === 'custom_type';
+ *   }
+ *
+ *   handle(message: Message): MessageHandlerResult {
+ *     // Process the message
+ *     console.log('Custom message:', message.content);
+ *
+ *     return {
+ *       type: 'custom_processed',
+ *       message,
+ *       timestamp: Date.now()
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * ## Registering Custom Handlers
+ *
+ * Add your handler to the message processor:
+ *
+ * ```typescript
+ * const agent = new AiAgent({ ... });
+ * await agent.initialize();
+ *
+ * // Get the message processor
+ * const processor = agent.getMessageProcessor();
+ *
+ * // Add custom handler with priority (lower = higher priority)
+ * processor.addHandler(new CustomHandler(), 5);
+ * ```
+ *
+ * ## Handler Priority
+ *
+ * Handlers are processed in priority order (lowest number first).
+ * Built-in handlers use priorities 0-100. Use higher numbers for
+ * handlers that should run after built-in processing.
+ *
+ * ```typescript
+ * processor.addHandler(new HighPriorityHandler(), 1);   // Runs first
+ * processor.addHandler(new LowPriorityHandler(), 200);  // Runs last
+ * ```
+ *
+ * ## Use Cases
+ *
+ * - **Analytics**: Track specific message types
+ * - **Transformations**: Modify messages before display
+ * - **Integrations**: Forward messages to external systems
+ * - **Custom UI**: Trigger specific UI behaviors
+ *
+ * @module CustomHandlers
+ * @category Advanced
+ */
+import { Message } from './Message.js';
+import { MessageHandlerResult } from './types.js';
+/**
+ * Base class for message handlers.
+ *
+ * All custom message handlers must extend this class and implement
+ * the `canHandle` and `handle` methods.
+ *
+ * @example Simple handler
+ * ```typescript
+ * class LoggingHandler extends BaseMessageHandler {
+ *   canHandle(message: Message): boolean {
+ *     return true;  // Handle all messages
+ *   }
+ *
+ *   handle(message: Message): MessageHandlerResult {
+ *     console.log(`[${message.persona}] ${message.content}`);
+ *     return {
+ *       type: 'logged',
+ *       message,
+ *       timestamp: Date.now()
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * @example Async handler
+ * ```typescript
+ * class AsyncHandler extends BaseMessageHandler {
+ *   canHandle(message: Message): boolean {
+ *     return message.role === 'needs_processing';
+ *   }
+ *
+ *   async handle(message: Message): Promise<MessageHandlerResult> {
+ *     const result = await processExternally(message);
+ *     return {
+ *       type: 'processed',
+ *       message,
+ *       data: result,
+ *       timestamp: Date.now()
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * @example Conditional handler
+ * ```typescript
+ * class SentimentHandler extends BaseMessageHandler {
+ *   canHandle(message: Message): boolean {
+ *     // Only handle agent messages with content
+ *     return message.persona === 'agent' && !!message.content;
+ *   }
+ *
+ *   handle(message: Message): MessageHandlerResult {
+ *     const sentiment = analyzeSentiment(message.content);
+ *     return {
+ *       type: 'sentiment_analyzed',
+ *       message,
+ *       sentiment,
+ *       timestamp: Date.now()
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * @category Advanced
+ * @group CustomHandlers
+ */
+export declare abstract class BaseMessageHandler {
+    /**
+     * Check if this handler can process the given message.
+     *
+     * This method is called for each incoming message. Return `true`
+     * if this handler should process the message, `false` otherwise.
+     *
+     * @param message - The incoming message to check
+     * @returns `true` if this handler can process the message
+     *
+     * @example
+     * ```typescript
+     * canHandle(message: Message): boolean {
+     *   // Handle only customer messages
+     *   return message.persona === 'customer';
+     * }
+     * ```
+     */
+    abstract canHandle(message: Message): boolean;
+    /**
+     * Process the message.
+     *
+     * Called when `canHandle` returns `true`. Implement your message
+     * processing logic here. Can be synchronous or asynchronous.
+     *
+     * @param message - The message to process
+     * @returns Handler result or Promise resolving to result
+     *
+     * @example Synchronous
+     * ```typescript
+     * handle(message: Message): MessageHandlerResult {
+     *   return {
+     *     type: 'processed',
+     *     message,
+     *     timestamp: Date.now()
+     *   };
+     * }
+     * ```
+     *
+     * @example Asynchronous
+     * ```typescript
+     * async handle(message: Message): Promise<MessageHandlerResult> {
+     *   await saveToDatabase(message);
+     *   return {
+     *     type: 'saved',
+     *     message,
+     *     timestamp: Date.now()
+     *   };
+     * }
+     * ```
+     */
+    abstract handle(message: Message): Promise<MessageHandlerResult> | MessageHandlerResult;
+}
+//# sourceMappingURL=BaseMessageHandler.d.ts.map

package/dist/core/message/BaseMessageHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseMessageHandler.d.ts","sourceRoot":"","sources":["../../../src/core/message/BaseMessageHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqFG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,8BAAsB,kBAAkB;IACtC;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB;CACxF"}

package/dist/core/message/BaseMessageHandler.js

@@ -0,0 +1,155 @@
+/**
+ * # Custom Message Handlers
+ *
+ * Message handlers process incoming messages from the AI Agent server.
+ * You can create custom handlers to implement specialized message processing,
+ * custom business logic, or integration with other systems.
+ *
+ * ## Overview
+ *
+ * The SDK uses a chain of message handlers to process incoming messages.
+ * Each handler can:
+ * - Decide if it can handle a specific message type
+ * - Process the message and return a result
+ * - Pass the message to the next handler in the chain
+ *
+ * ## Built-in Handlers
+ *
+ * The SDK includes these handlers by default:
+ * - `AgentMessageHandler` - Processes agent responses
+ * - `HeartbeatHandler` - Handles typing indicators
+ * - `ErrorMessageHandler` - Handles error messages
+ * - `TokenRefreshHandler` - Handles token refresh requests
+ * - `ChatHistoryHandler` - Processes chat history messages
+ *
+ * ## Creating a Custom Handler
+ *
+ * Extend `BaseMessageHandler` to create your own:
+ *
+ * ```typescript
+ * import { BaseMessageHandler, Message, MessageHandlerResult } from "@eGain/ai-agent-sdk";
+ *
+ * class CustomHandler extends BaseMessageHandler {
+ *   canHandle(message: Message): boolean {
+ *     // Return true if this handler should process the message
+ *     return message.role === 'custom_type';
+ *   }
+ *
+ *   handle(message: Message): MessageHandlerResult {
+ *     // Process the message
+ *     console.log('Custom message:', message.content);
+ *
+ *     return {
+ *       type: 'custom_processed',
+ *       message,
+ *       timestamp: Date.now()
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * ## Registering Custom Handlers
+ *
+ * Add your handler to the message processor:
+ *
+ * ```typescript
+ * const agent = new AiAgent({ ... });
+ * await agent.initialize();
+ *
+ * // Get the message processor
+ * const processor = agent.getMessageProcessor();
+ *
+ * // Add custom handler with priority (lower = higher priority)
+ * processor.addHandler(new CustomHandler(), 5);
+ * ```
+ *
+ * ## Handler Priority
+ *
+ * Handlers are processed in priority order (lowest number first).
+ * Built-in handlers use priorities 0-100. Use higher numbers for
+ * handlers that should run after built-in processing.
+ *
+ * ```typescript
+ * processor.addHandler(new HighPriorityHandler(), 1);   // Runs first
+ * processor.addHandler(new LowPriorityHandler(), 200);  // Runs last
+ * ```
+ *
+ * ## Use Cases
+ *
+ * - **Analytics**: Track specific message types
+ * - **Transformations**: Modify messages before display
+ * - **Integrations**: Forward messages to external systems
+ * - **Custom UI**: Trigger specific UI behaviors
+ *
+ * @module CustomHandlers
+ * @category Advanced
+ */
+/**
+ * Base class for message handlers.
+ *
+ * All custom message handlers must extend this class and implement
+ * the `canHandle` and `handle` methods.
+ *
+ * @example Simple handler
+ * ```typescript
+ * class LoggingHandler extends BaseMessageHandler {
+ *   canHandle(message: Message): boolean {
+ *     return true;  // Handle all messages
+ *   }
+ *
+ *   handle(message: Message): MessageHandlerResult {
+ *     console.log(`[${message.persona}] ${message.content}`);
+ *     return {
+ *       type: 'logged',
+ *       message,
+ *       timestamp: Date.now()
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * @example Async handler
+ * ```typescript
+ * class AsyncHandler extends BaseMessageHandler {
+ *   canHandle(message: Message): boolean {
+ *     return message.role === 'needs_processing';
+ *   }
+ *
+ *   async handle(message: Message): Promise<MessageHandlerResult> {
+ *     const result = await processExternally(message);
+ *     return {
+ *       type: 'processed',
+ *       message,
+ *       data: result,
+ *       timestamp: Date.now()
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * @example Conditional handler
+ * ```typescript
+ * class SentimentHandler extends BaseMessageHandler {
+ *   canHandle(message: Message): boolean {
+ *     // Only handle agent messages with content
+ *     return message.persona === 'agent' && !!message.content;
+ *   }
+ *
+ *   handle(message: Message): MessageHandlerResult {
+ *     const sentiment = analyzeSentiment(message.content);
+ *     return {
+ *       type: 'sentiment_analyzed',
+ *       message,
+ *       sentiment,
+ *       timestamp: Date.now()
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * @category Advanced
+ * @group CustomHandlers
+ */
+export class BaseMessageHandler {
+}
+//# sourceMappingURL=BaseMessageHandler.js.map

package/dist/core/message/BaseMessageHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseMessageHandler.js","sourceRoot":"","sources":["../../../src/core/message/BaseMessageHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqFG;AAKH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,MAAM,OAAgB,kBAAkB;CAqDvC"}

package/dist/core/message/Message.d.ts

@@ -0,0 +1,69 @@
+import { Persona, Role, MessageData, SessionContext } from './types.js';
+/**
+ * Message class representing both incoming and outgoing messages
+ */
+export declare class Message {
+    readonly messageId?: string;
+    readonly persona: Persona;
+    readonly role: Role;
+    readonly content?: string;
+    readonly messageData?: MessageData;
+    readonly timestamp: number;
+    readonly from?: string;
+    readonly to?: string;
+    readonly agentId?: any;
+    readonly sessionId?: any;
+    /**
+     * Create a new Message instance
+     */
+    constructor(persona: Persona, role: Role, content?: string, options?: {
+        messageId?: string;
+        messageData?: MessageData;
+        timestamp?: number;
+        from?: string;
+        to?: string;
+        agentId?: string;
+        sessionId?: string;
+    });
+    /**
+     * Validate message structure
+     * @throws {Error} If message is invalid
+     */
+    validate(): void;
+    /**
+     * Convert message to payload string (JSON) for transmission
+     * Outgoing payload is configured here
+     * @returns JSON string
+     */
+    toPayloadString(): string;
+    /**
+     * Create a Message instance from JSON data (typically from WebSocket)
+     */
+    static fromJSON(data: any, sessionContext: SessionContext): Message;
+    /**
+     * Check if this is an incoming message
+     * Incoming messages come from the server (agent, system, or metadata)
+     * Can also be identified by the 'from' field if it's set to an agent ID
+     */
+    isIncoming(): boolean;
+    /**
+     * Check if this is an outgoing message
+     * Outgoing messages are sent by the client (customer)
+     * Can also be identified by the 'from' field if it's set to a customer/client ID
+     */
+    isOutgoing(): boolean;
+    /**
+     * Create a copy of this message with updated fields
+     */
+    clone(updates?: Partial<{
+        persona: Persona;
+        role: Role;
+        content: string;
+        messageId: string;
+        messageData: MessageData;
+        timestamp: number;
+        from: string;
+        to: string;
+    }>): Message;
+}
+//# sourceMappingURL=Message.d.ts.map

package/dist/core/message/Message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Message.d.ts","sourceRoot":"","sources":["../../../src/core/message/Message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAW,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjF;;GAEG;AACH,qBAAa,OAAO;IAClB,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnC,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,IAAI,EAAE,IAAI,CAAC;IAC3B,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjC,SAAgB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1C,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,EAAE,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAgB,OAAO,CAAC,EAAE,GAAG,CAAC;IAC9B,SAAgB,SAAS,CAAC,EAAE,GAAG,CAAC;IAEhC;;OAEG;gBAED,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;IAcH;;;OAGG;IACH,QAAQ,IAAI,IAAI;IAYhB;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAoBzB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO;IAgCnE;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAarB;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAerB;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QACtB,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,IAAI,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,WAAW,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC,GAAG,OAAO;CAcb"}

package/dist/core/message/Message.js

@@ -0,0 +1,131 @@
+import { PERSONA } from './types.js';
+/**
+ * Message class representing both incoming and outgoing messages
+ */
+export class Message {
+    /**
+     * Create a new Message instance
+     */
+    constructor(persona, role, content, options) {
+        this.persona = persona;
+        this.role = role;
+        this.content = content;
+        this.messageId = options?.messageId;
+        this.messageData = options?.messageData;
+        this.timestamp = options?.timestamp ?? Date.now();
+        this.from = options?.from;
+        this.to = options?.to;
+        this.agentId = options?.agentId;
+        this.sessionId = options?.sessionId;
+    }
+    /**
+     * Validate message structure
+     * @throws {Error} If message is invalid
+     */
+    validate() {
+        if (!this.persona) {
+            throw new Error('Message must have a persona');
+        }
+        if (!this.role) {
+            throw new Error('Message must have a role');
+        }
+        if (this.content !== undefined && typeof this.content !== 'string') {
+            throw new Error('Message content must be a string');
+        }
+    }
+    /**
+     * Convert message to payload string (JSON) for transmission
+     * Outgoing payload is configured here
+     * @returns JSON string
+     */
+    toPayloadString() {
+        this.validate();
+        const payload = {
+            persona: this.persona,
+            role: this.role,
+        };
+        // Only include content if it's defined
+        if (this.content !== undefined) {
+            payload.content = this.content;
+        }
+        // Include messageData if present (for context, escalation, feedback, etc.)
+        if (this.messageData) {
+            payload.messageData = this.messageData;
+        }
+        return JSON.stringify(payload);
+    }
+    /**
+     * Create a Message instance from JSON data (typically from WebSocket)
+     */
+    static fromJSON(data, sessionContext) {
+        if (typeof data === 'string') {
+            data = JSON.parse(data);
+        }
+        if (!sessionContext) {
+            throw new Error('Session context is required');
+        }
+        if (!data || typeof data !== 'object') {
+            throw new Error('Invalid message data: must be an object');
+        }
+        const message = new Message(data.persona, data.role, data.content || '', {
+            messageId: data.messageId,
+            messageData: data.messageData,
+            timestamp: data.timestamp,
+            from: sessionContext.agentName,
+            to: sessionContext.customerName,
+            agentId: sessionContext.agentId,
+            sessionId: sessionContext.sessionId,
+        });
+        message.validate();
+        return message;
+    }
+    /**
+     * Check if this is an incoming message
+     * Incoming messages come from the server (agent, system, or metadata)
+     * Can also be identified by the 'from' field if it's set to an agent ID
+     */
+    isIncoming() {
+        // If 'from' field is set and persona is agent/system/metadata, it's incoming
+        if (this.from && (this.persona === PERSONA.AGENT || this.persona === PERSONA.SYSTEM || this.persona === PERSONA.METADATA)) {
+            return true;
+        }
+        // Fallback to checking persona (server-side personas are incoming)
+        if (this.persona === PERSONA.AGENT || this.persona === PERSONA.SYSTEM || this.persona === PERSONA.METADATA) {
+            return true;
+        }
+        // If messageId is set, it's likely incoming (set by server)
+        return !!this.messageId;
+    }
+    /**
+     * Check if this is an outgoing message
+     * Outgoing messages are sent by the client (customer)
+     * Can also be identified by the 'from' field if it's set to a customer/client ID
+     */
+    isOutgoing() {
+        // Customer persona messages are always outgoing
+        if (this.persona === PERSONA.CUSTOMER) {
+            return true;
+        }
+        // If 'from' field indicates a customer/client and persona is system, it's outgoing
+        // (e.g., context messages, escalation, feedback sent by client)
+        if (this.persona === PERSONA.SYSTEM && this.from && !this.messageId) {
+            // System messages without messageId and with 'from' are likely outgoing
+            return true;
+        }
+        // Default: if no messageId and persona is customer, it's outgoing
+        return false;
+    }
+    /**
+     * Create a copy of this message with updated fields
+     */
+    clone(updates) {
+        return new Message(updates?.persona ?? this.persona, updates?.role ?? this.role, updates?.content ?? this.content, {
+            messageId: updates?.messageId ?? this.messageId,
+            messageData: updates?.messageData ?? this.messageData,
+            timestamp: updates?.timestamp ?? this.timestamp,
+            from: updates?.from ?? this.from,
+            to: updates?.to ?? this.to,
+        });
+    }
+}
+//# sourceMappingURL=Message.js.map

package/dist/core/message/Message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Message.js","sourceRoot":"","sources":["../../../src/core/message/Message.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,OAAO,EAAkB,MAAM,YAAY,CAAC;AAEjF;;GAEG;AACH,MAAM,OAAO,OAAO;IAYlB;;OAEG;IACH,YACE,OAAgB,EAChB,IAAU,EACV,OAAgB,EAChB,OAQC;QAED,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;QAC1B,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,eAAe;QACb,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,MAAM,OAAO,GAAQ;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;QAEF,uCAAuC;QACvC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QACjC,CAAC;QAED,2EAA2E;QAC3E,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACzC,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAS,EAAE,cAA8B;QACvD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,OAAO,CACzB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,OAAO,IAAI,EAAE,EAClB;YACE,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,cAAc,CAAC,SAAS;YAC9B,EAAE,EAAE,cAAc,CAAC,YAAY;YAC/B,OAAO,EAAE,cAAc,CAAC,OAAO;YAC/B,SAAS,EAAE,cAAc,CAAC,SAAS;SACpC,CACF,CAAC;QAEF,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,6EAA6E;QAC7E,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1H,OAAO,IAAI,CAAC;QACd,CAAC;QACD,mEAAmE;QACnE,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC3G,OAAO,IAAI,CAAC;QACd,CAAC;QACD,4DAA4D;QAC5D,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,gDAAgD;QAChD,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,mFAAmF;QACnF,gEAAgE;QAChE,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpE,wEAAwE;YACxE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,kEAAkE;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OASJ;QACA,OAAO,IAAI,OAAO,CAChB,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO,EAChC,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,EAC1B,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO,EAChC;YACE,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,SAAS;YAC/C,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC,WAAW;YACrD,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,SAAS;YAC/C,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI;YAChC,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE;SAC3B,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/core/message/MessageProcessor.d.ts

@@ -0,0 +1,51 @@
+import { BaseMessageHandler } from './BaseMessageHandler.js';
+import { Message } from './Message.js';
+import { MessageHandlerResult } from './types.js';
+import { Logger } from '../logging/Logger.js';
+/**
+ * MessageProcessor class that routes messages to appropriate handlers
+ * Uses a handler registry pattern where handlers are checked in priority order
+ */
+export declare class MessageProcessor {
+    private handlers;
+    private logger;
+    /**
+     * Create a new MessageProcessor instance
+     * Registers default handlers
+     */
+    constructor(logger?: Logger);
+    /**
+     * Register default handlers in priority order
+     * More specific handlers should come first (lower index = higher priority)
+     * The first handler that can process a message wins
+     */
+    private registerDefaultHandlers;
+    /**
+     * Process an incoming message
+     * Routes the message to the first handler that can process it
+     * @param message - The incoming message
+     * @returns Processing result or null if no handler matched
+     */
+    process(message: Message): Promise<MessageHandlerResult | null>;
+    /**
+     * Add a custom handler
+     * @param handler - Handler instance
+     * @param priority - Position to insert (lower = higher priority, default: end of list)
+     */
+    addHandler(handler: BaseMessageHandler, priority?: number): void;
+    /**
+     * Remove a handler
+     * @param handler - Handler instance to remove
+     */
+    removeHandler(handler: BaseMessageHandler): void;
+    /**
+     * Get all registered handlers
+     * @returns Array of registered handlers
+     */
+    getHandlers(): BaseMessageHandler[];
+    /**
+     * Clear all handlers and re-register defaults
+     */
+    reset(): void;
+}
+//# sourceMappingURL=MessageProcessor.d.ts.map

package/dist/core/message/MessageProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageProcessor.d.ts","sourceRoot":"","sources":["../../../src/core/message/MessageProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMlD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAG9C;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,MAAM,CAAS;IAEvB;;;OAGG;gBACS,MAAM,CAAC,EAAE,MAAM;IAK3B;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAa/B;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAkCrE;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAiBhE;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAQhD;;;OAGG;IACH,WAAW,IAAI,kBAAkB,EAAE;IAInC;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}