@egain/ai-agent-sdk 0.1.0

package/dist/core/queue/MessageQueue.d.ts

@@ -0,0 +1,277 @@
+/**
+ * # Message Queue
+ *
+ * The Message Queue feature provides automatic message buffering when the
+ * connection is unavailable. Messages are queued locally and automatically
+ * sent when the connection is restored.
+ *
+ * ## Overview
+ *
+ * When you call `agent.send()` while disconnected:
+ * 1. The message is added to an internal queue
+ * 2. The SDK continues without throwing an error
+ * 3. When connection is restored, queued messages are sent automatically
+ * 4. A `queueFlushed` event is emitted with the count of sent messages
+ *
+ * ## Quick Start
+ *
+ * Message queuing works automatically:
+ *
+ * ```typescript
+ * // This works even if disconnected
+ * await agent.send("Hello!");  // Queued if offline
+ *
+ * // Check queue status
+ * const queueSize = agent.getQueueSize();
+ * console.log(`${queueSize} messages waiting`);
+ *
+ * // Clear the queue if needed
+ * agent.clearQueue();
+ * ```
+ *
+ * ## Queue Events
+ *
+ * Listen for queue-related events:
+ *
+ * ```typescript
+ * agent.on('queueFlushed', (event) => {
+ *   console.log(`Sent ${event.payload.count} queued messages`);
+ * });
+ * ```
+ *
+ * ## Configuration
+ *
+ * Configure queue behavior when creating the agent:
+ *
+ * ```typescript
+ * const agent = new AiAgent({
+ *   id: "agent-id",
+ *   endpoint: "https://your-endpoint.com",
+ *   maxQueueSize: 1000  // Maximum messages to queue (default: 1000)
+ * });
+ * ```
+ *
+ * ## Retry Behavior
+ *
+ * The queue includes automatic retry logic:
+ * - Each message is retried up to 3 times
+ * - Failed messages are removed after max attempts
+ * - An error event is emitted for failed messages
+ *
+ * ## Use Cases
+ *
+ * - **Offline Support**: Continue sending while temporarily disconnected
+ * - **Network Resilience**: Handle flaky network connections
+ * - **User Experience**: No need to handle connection state in UI
+ *
+ * @module MessageQueue
+ * @category Features
+ */
+/**
+ * Queued message with metadata for retry handling.
+ *
+ * Each queued message includes a unique ID for idempotency,
+ * timestamp for ordering, and attempt counter for retry logic.
+ *
+ * @example
+ * ```typescript
+ * const queuedMessage: QueuedMessage = {
+ *   id: "msg-123",
+ *   data: { persona: "customer", content: "Hello" },
+ *   timestamp: Date.now(),
+ *   attempts: 0
+ * };
+ * ```
+ *
+ * @category Features
+ * @group MessageQueue
+ */
+export interface QueuedMessage {
+    /** Unique message identifier for idempotency */
+    id: string;
+    /** The message payload to be sent */
+    data: any;
+    /** Timestamp when the message was queued */
+    timestamp: number;
+    /** Number of send attempts made */
+    attempts: number;
+}
+/**
+ * FIFO message queue with idempotency and retry support.
+ *
+ * The MessageQueue class manages outgoing messages when the connection
+ * is unavailable. Messages are stored in order and sent when the
+ * connection is restored.
+ *
+ * @example Basic usage
+ * ```typescript
+ * const queue = new MessageQueue(1000, 3);  // max 1000 messages, 3 retries
+ *
+ * // Add a message
+ * const id = queue.enqueue({ text: "Hello" });
+ *
+ * // Check queue status
+ * console.log(`Queue size: ${queue.size()}`);
+ * console.log(`Is empty: ${queue.isEmpty()}`);
+ *
+ * // Process messages
+ * while (!queue.isEmpty()) {
+ *   const message = queue.peek();
+ *   try {
+ *     await sendToServer(message.data);
+ *     queue.dequeue();  // Remove on success
+ *   } catch (error) {
+ *     const shouldRetry = queue.markAttempted(message.id);
+ *     if (!shouldRetry) {
+ *       queue.remove(message.id);  // Max retries exceeded
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example With custom ID
+ * ```typescript
+ * // Use custom ID for idempotency
+ * const messageId = queue.enqueue(data, "custom-id-123");
+ *
+ * // Later, you can remove by ID
+ * queue.remove("custom-id-123");
+ * ```
+ *
+ * @category Features
+ * @group MessageQueue
+ */
+export declare class MessageQueue {
+    private queue;
+    private maxSize;
+    private maxAttempts;
+    /**
+     * Create a new MessageQueue
+     * @param maxSize - Maximum number of messages to queue (default: 1000)
+     * @param maxAttempts - Maximum send attempts per message (default: 3)
+     */
+    constructor(maxSize?: number, maxAttempts?: number);
+    /**
+     * Add a message to the queue.
+     *
+     * Messages are added to the end of the queue (FIFO order).
+     * If the queue is full, a MessageError is thrown.
+     *
+     * @param data - The message data to queue
+     * @param id - Optional custom message ID (auto-generated if not provided)
+     * @returns The message ID
+     * @throws MessageError if queue is full
+     *
+     * @example
+     * ```typescript
+     * // Auto-generated ID
+     * const id1 = queue.enqueue({ text: "Hello" });
+     *
+     * // Custom ID for tracking
+     * const id2 = queue.enqueue({ text: "World" }, "my-message-id");
+     * ```
+     */
+    enqueue(data: any, id?: string): string;
+    /**
+     * Get the next message without removing it.
+     *
+     * Use this to inspect the next message before deciding
+     * whether to process and remove it.
+     *
+     * @returns The next message or null if queue is empty
+     *
+     * @example
+     * ```typescript
+     * const next = queue.peek();
+     * if (next) {
+     *   console.log(`Next message: ${next.id}`);
+     * }
+     * ```
+     */
+    peek(): QueuedMessage | null;
+    /**
+     * Remove and return the next message from the queue.
+     *
+     * Call this after successfully processing a message.
+     *
+     * @returns The removed message or null if queue is empty
+     *
+     * @example
+     * ```typescript
+     * const message = queue.dequeue();
+     * if (message) {
+     *   await processMessage(message.data);
+     * }
+     * ```
+     */
+    dequeue(): QueuedMessage | null;
+    /**
+     * Mark a message as attempted and check if retry is allowed.
+     *
+     * Call this when a send attempt fails. Returns true if the
+     * message should be retried, false if max attempts exceeded.
+     *
+     * @param id - The message ID to mark
+     * @returns True if retry is allowed, false if max attempts reached
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await sendMessage(message.data);
+     *   queue.dequeue();
+     * } catch (error) {
+     *   const shouldRetry = queue.markAttempted(message.id);
+     *   if (!shouldRetry) {
+     *     queue.remove(message.id);
+     *     console.error(`Message ${message.id} failed permanently`);
+     *   }
+     * }
+     * ```
+     */
+    markAttempted(id: string): boolean;
+    /**
+     * Remove a message by ID.
+     *
+     * Use this to remove a message that failed permanently
+     * or is no longer needed.
+     *
+     * @param id - The message ID to remove
+     * @returns True if message was found and removed
+     *
+     * @example
+     * ```typescript
+     * const removed = queue.remove("message-id");
+     * console.log(removed ? "Removed" : "Not found");
+     * ```
+     */
+    remove(id: string): boolean;
+    /**
+     * Get the current number of messages in the queue.
+     * @returns Number of queued messages
+     */
+    size(): number;
+    /**
+     * Check if the queue is empty.
+     * @returns True if no messages are queued
+     */
+    isEmpty(): boolean;
+    /**
+     * Remove all messages from the queue.
+     *
+     * Use with caution - all queued messages will be lost.
+     */
+    clear(): void;
+    /**
+     * Get all messages in the queue (for debugging).
+     *
+     * Returns a read-only copy of the queue contents.
+     *
+     * @returns Array of all queued messages
+     */
+    getAll(): readonly QueuedMessage[];
+    /**
+     * Generate a unique message ID
+     */
+    private generateId;
+}
+//# sourceMappingURL=MessageQueue.d.ts.map

package/dist/core/queue/MessageQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageQueue.d.ts","sourceRoot":"","sources":["../../../src/core/queue/MessageQueue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AAIH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,IAAI,EAAE,GAAG,CAAC;IACV,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;gBACS,OAAO,GAAE,MAAa,EAAE,WAAW,GAAE,MAAU;IAK3D;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAiBvC;;;;;;;;;;;;;;;OAeG;IACH,IAAI,IAAI,aAAa,GAAG,IAAI;IAI5B;;;;;;;;;;;;;;OAcG;IACH,OAAO,IAAI,aAAa,GAAG,IAAI;IAI/B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IASlC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS3B;;;OAGG;IACH,IAAI,IAAI,MAAM;IAId;;;OAGG;IACH,OAAO,IAAI,OAAO;IAIlB;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;OAMG;IACH,MAAM,IAAI,SAAS,aAAa,EAAE;IAIlC;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB"}

package/dist/core/queue/MessageQueue.js

@@ -0,0 +1,291 @@
+/**
+ * # Message Queue
+ *
+ * The Message Queue feature provides automatic message buffering when the
+ * connection is unavailable. Messages are queued locally and automatically
+ * sent when the connection is restored.
+ *
+ * ## Overview
+ *
+ * When you call `agent.send()` while disconnected:
+ * 1. The message is added to an internal queue
+ * 2. The SDK continues without throwing an error
+ * 3. When connection is restored, queued messages are sent automatically
+ * 4. A `queueFlushed` event is emitted with the count of sent messages
+ *
+ * ## Quick Start
+ *
+ * Message queuing works automatically:
+ *
+ * ```typescript
+ * // This works even if disconnected
+ * await agent.send("Hello!");  // Queued if offline
+ *
+ * // Check queue status
+ * const queueSize = agent.getQueueSize();
+ * console.log(`${queueSize} messages waiting`);
+ *
+ * // Clear the queue if needed
+ * agent.clearQueue();
+ * ```
+ *
+ * ## Queue Events
+ *
+ * Listen for queue-related events:
+ *
+ * ```typescript
+ * agent.on('queueFlushed', (event) => {
+ *   console.log(`Sent ${event.payload.count} queued messages`);
+ * });
+ * ```
+ *
+ * ## Configuration
+ *
+ * Configure queue behavior when creating the agent:
+ *
+ * ```typescript
+ * const agent = new AiAgent({
+ *   id: "agent-id",
+ *   endpoint: "https://your-endpoint.com",
+ *   maxQueueSize: 1000  // Maximum messages to queue (default: 1000)
+ * });
+ * ```
+ *
+ * ## Retry Behavior
+ *
+ * The queue includes automatic retry logic:
+ * - Each message is retried up to 3 times
+ * - Failed messages are removed after max attempts
+ * - An error event is emitted for failed messages
+ *
+ * ## Use Cases
+ *
+ * - **Offline Support**: Continue sending while temporarily disconnected
+ * - **Network Resilience**: Handle flaky network connections
+ * - **User Experience**: No need to handle connection state in UI
+ *
+ * @module MessageQueue
+ * @category Features
+ */
+import { MessageError } from '../errors/SDKError.js';
+/**
+ * FIFO message queue with idempotency and retry support.
+ *
+ * The MessageQueue class manages outgoing messages when the connection
+ * is unavailable. Messages are stored in order and sent when the
+ * connection is restored.
+ *
+ * @example Basic usage
+ * ```typescript
+ * const queue = new MessageQueue(1000, 3);  // max 1000 messages, 3 retries
+ *
+ * // Add a message
+ * const id = queue.enqueue({ text: "Hello" });
+ *
+ * // Check queue status
+ * console.log(`Queue size: ${queue.size()}`);
+ * console.log(`Is empty: ${queue.isEmpty()}`);
+ *
+ * // Process messages
+ * while (!queue.isEmpty()) {
+ *   const message = queue.peek();
+ *   try {
+ *     await sendToServer(message.data);
+ *     queue.dequeue();  // Remove on success
+ *   } catch (error) {
+ *     const shouldRetry = queue.markAttempted(message.id);
+ *     if (!shouldRetry) {
+ *       queue.remove(message.id);  // Max retries exceeded
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example With custom ID
+ * ```typescript
+ * // Use custom ID for idempotency
+ * const messageId = queue.enqueue(data, "custom-id-123");
+ *
+ * // Later, you can remove by ID
+ * queue.remove("custom-id-123");
+ * ```
+ *
+ * @category Features
+ * @group MessageQueue
+ */
+export class MessageQueue {
+    /**
+     * Create a new MessageQueue
+     * @param maxSize - Maximum number of messages to queue (default: 1000)
+     * @param maxAttempts - Maximum send attempts per message (default: 3)
+     */
+    constructor(maxSize = 1000, maxAttempts = 3) {
+        this.queue = [];
+        this.maxSize = maxSize;
+        this.maxAttempts = maxAttempts;
+    }
+    /**
+     * Add a message to the queue.
+     *
+     * Messages are added to the end of the queue (FIFO order).
+     * If the queue is full, a MessageError is thrown.
+     *
+     * @param data - The message data to queue
+     * @param id - Optional custom message ID (auto-generated if not provided)
+     * @returns The message ID
+     * @throws MessageError if queue is full
+     *
+     * @example
+     * ```typescript
+     * // Auto-generated ID
+     * const id1 = queue.enqueue({ text: "Hello" });
+     *
+     * // Custom ID for tracking
+     * const id2 = queue.enqueue({ text: "World" }, "my-message-id");
+     * ```
+     */
+    enqueue(data, id) {
+        if (this.queue.length >= this.maxSize) {
+            throw new MessageError(`Queue is full (max size: ${this.maxSize})`);
+        }
+        const messageId = id || this.generateId();
+        const message = {
+            id: messageId,
+            data,
+            timestamp: Date.now(),
+            attempts: 0,
+        };
+        this.queue.push(message);
+        return messageId;
+    }
+    /**
+     * Get the next message without removing it.
+     *
+     * Use this to inspect the next message before deciding
+     * whether to process and remove it.
+     *
+     * @returns The next message or null if queue is empty
+     *
+     * @example
+     * ```typescript
+     * const next = queue.peek();
+     * if (next) {
+     *   console.log(`Next message: ${next.id}`);
+     * }
+     * ```
+     */
+    peek() {
+        return this.queue.length > 0 ? this.queue[0] : null;
+    }
+    /**
+     * Remove and return the next message from the queue.
+     *
+     * Call this after successfully processing a message.
+     *
+     * @returns The removed message or null if queue is empty
+     *
+     * @example
+     * ```typescript
+     * const message = queue.dequeue();
+     * if (message) {
+     *   await processMessage(message.data);
+     * }
+     * ```
+     */
+    dequeue() {
+        return this.queue.shift() || null;
+    }
+    /**
+     * Mark a message as attempted and check if retry is allowed.
+     *
+     * Call this when a send attempt fails. Returns true if the
+     * message should be retried, false if max attempts exceeded.
+     *
+     * @param id - The message ID to mark
+     * @returns True if retry is allowed, false if max attempts reached
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await sendMessage(message.data);
+     *   queue.dequeue();
+     * } catch (error) {
+     *   const shouldRetry = queue.markAttempted(message.id);
+     *   if (!shouldRetry) {
+     *     queue.remove(message.id);
+     *     console.error(`Message ${message.id} failed permanently`);
+     *   }
+     * }
+     * ```
+     */
+    markAttempted(id) {
+        const message = this.queue.find((msg) => msg.id === id);
+        if (message) {
+            message.attempts++;
+            return message.attempts < this.maxAttempts;
+        }
+        return false;
+    }
+    /**
+     * Remove a message by ID.
+     *
+     * Use this to remove a message that failed permanently
+     * or is no longer needed.
+     *
+     * @param id - The message ID to remove
+     * @returns True if message was found and removed
+     *
+     * @example
+     * ```typescript
+     * const removed = queue.remove("message-id");
+     * console.log(removed ? "Removed" : "Not found");
+     * ```
+     */
+    remove(id) {
+        const index = this.queue.findIndex((msg) => msg.id === id);
+        if (index !== -1) {
+            this.queue.splice(index, 1);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get the current number of messages in the queue.
+     * @returns Number of queued messages
+     */
+    size() {
+        return this.queue.length;
+    }
+    /**
+     * Check if the queue is empty.
+     * @returns True if no messages are queued
+     */
+    isEmpty() {
+        return this.queue.length === 0;
+    }
+    /**
+     * Remove all messages from the queue.
+     *
+     * Use with caution - all queued messages will be lost.
+     */
+    clear() {
+        this.queue = [];
+    }
+    /**
+     * Get all messages in the queue (for debugging).
+     *
+     * Returns a read-only copy of the queue contents.
+     *
+     * @returns Array of all queued messages
+     */
+    getAll() {
+        return [...this.queue];
+    }
+    /**
+     * Generate a unique message ID
+     */
+    generateId() {
+        return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+    }
+}
+//# sourceMappingURL=MessageQueue.js.map

package/dist/core/queue/MessageQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageQueue.js","sourceRoot":"","sources":["../../../src/core/queue/MessageQueue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAgCrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,OAAO,YAAY;IAKvB;;;;OAIG;IACH,YAAY,UAAkB,IAAI,EAAE,cAAsB,CAAC;QATnD,UAAK,GAAoB,EAAE,CAAC;QAUlC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,IAAS,EAAE,EAAW;QAC5B,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,IAAI,YAAY,CAAC,4BAA4B,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,SAAS,GAAG,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAkB;YAC7B,EAAE,EAAE,SAAS;YACb,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,QAAQ,EAAE,CAAC;SACZ,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,aAAa,CAAC,EAAU;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACxD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC;QAC7C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAU;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;IAED;;;;;;OAMG;IACH,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,UAAU;QAChB,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACxE,CAAC;CACF"}

package/dist/core/types/PortalTypes.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Portal types for the CC (Contact Center) widget initialization flow.
+ * Derived from the cc-widget's portalService and store types.
+ *
+ * @module PortalTypes
+ */
+/**
+ * Represents a knowledge portal accessible to the user.
+ *
+ * @interface Portal
+ */
+export interface Portal {
+    /** Unique identifier (string or number) */
+    id: string | number;
+    /** Display name of the portal */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** Optional department association */
+    department?: {
+        id: number;
+        name: string;
+    };
+}
+/**
+ * Represents a user profile within a portal.
+ *
+ * @interface UserProfile
+ */
+export interface UserProfile {
+    /** Unique identifier (string or number) */
+    id: string | number;
+    /** Display name of the profile */
+    name: string;
+    /** Whether this profile was last used in the current portal */
+    isLastUsedInPortal?: boolean;
+}
+/**
+ * Represents an AI agent in the agent selection list.
+ *
+ * @interface AgentListItem
+ */
+export interface AgentListItem {
+    /** Unique agent identifier */
+    agentId: string;
+    /** Display name of the agent */
+    name: string;
+    /** Optional description */
+    description?: string;
+}
+//# sourceMappingURL=PortalTypes.d.ts.map

package/dist/core/types/PortalTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PortalTypes.d.ts","sourceRoot":"","sources":["../../../src/core/types/PortalTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,2CAA2C;IAC3C,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/core/types/PortalTypes.js

@@ -0,0 +1,8 @@
+/**
+ * Portal types for the CC (Contact Center) widget initialization flow.
+ * Derived from the cc-widget's portalService and store types.
+ *
+ * @module PortalTypes
+ */
+export {};
+//# sourceMappingURL=PortalTypes.js.map

package/dist/core/types/PortalTypes.js.map

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