@egain/ai-agent-sdk 0.1.0

package/dist/core/platform/PlatformScriptLoader.js

@@ -0,0 +1,110 @@
+/**
+ * Dynamic loader for platform connector scripts.
+ *
+ * In browser environments, injects a `<script>` tag. In non-browser
+ * environments (Node.js, SSR), falls back to dynamic `import()` using
+ * the same constructed URL.
+ *
+ * @module PlatformScriptLoader
+ */
+const ENV_BASE_URLS = {
+    dev: 'https://dev-apps.egeng.info/',
+    qa: 'https://qa-apps.egeng.info/',
+    prod: 'https://apps.egain.services/',
+    stage: 'https://non-prod-apps.egain.services/',
+    euprod: 'https://apps.egain.cloud/',
+    eustage: 'https://non-prod-apps.egain.cloud/',
+    devrf: 'https://dev-apps.ezdev.net/',
+};
+/**
+ * Derive the deployment environment from available state.
+ *
+ * Priority: explicit env string > parsed from domain (dev-/qa- prefix) > "prod".
+ */
+export function deriveEnvironment(domain, explicitEnv) {
+    if (explicitEnv) {
+        const env = explicitEnv.toLowerCase();
+        if (env === 'dev' || env === 'qa' || env === 'prod')
+            return env;
+    }
+    if (domain) {
+        const d = domain.toLowerCase();
+        if (d.startsWith('dev-') || d.includes('dev-'))
+            return 'dev';
+        if (d.startsWith('qa-') || d.includes('qa-'))
+            return 'qa';
+    }
+    return 'prod';
+}
+/**
+ * Construct the connector script URL for a given platform and environment.
+ */
+export function buildPlatformScriptUrl(platform, environment) {
+    const baseUrl = ENV_BASE_URLS[environment] ?? ENV_BASE_URLS.prod;
+    return `${baseUrl}ai-agent-connector-${platform}/web/static/connector-ai-agent.js`;
+}
+/**
+ * Load a platform connector script.
+ *
+ * - **Browser:** Injects a `<script>` tag into `document.head`, waits for
+ *   `onload` + 100ms buffer, then verifies `window.PlatformComponentService`.
+ * - **Non-browser:** Uses dynamic `import()` with the same constructed URL.
+ *   The imported module must export `PlatformComponentService` as a default
+ *   or named export.
+ */
+export async function loadPlatformScript(options) {
+    const { platform, baseUrl, overrideUrl, logger } = options;
+    const scriptUrl = overrideUrl ?? buildPlatformScriptUrl(platform, baseUrl);
+    const isBrowser = typeof document !== 'undefined';
+    if (isBrowser) {
+        await loadViaBrowserScript(scriptUrl, logger);
+    }
+    else {
+        await loadViaDynamicImport(scriptUrl, logger);
+    }
+}
+async function loadViaBrowserScript(url, logger) {
+    logger.info('Loading platform connector script via <script> tag', { url });
+    return new Promise((resolve, reject) => {
+        const script = document.createElement('script');
+        script.src = url;
+        script.async = true;
+        script.crossOrigin = 'anonymous';
+        script.onload = () => {
+            setTimeout(() => {
+                if (window.PlatformComponentService) {
+                    logger.info('PlatformComponentService registered successfully');
+                    resolve();
+                }
+                else {
+                    reject(new Error(`Platform connector script loaded from "${url}" but window.PlatformComponentService was not registered`));
+                }
+            }, 100);
+        };
+        script.onerror = () => {
+            reject(new Error(`Failed to load platform connector script from "${url}"`));
+        };
+        document.head.appendChild(script);
+    });
+}
+async function loadViaDynamicImport(url, logger) {
+    logger.info('Loading platform connector module via dynamic import()', { url });
+    try {
+        const mod = await import(/* webpackIgnore: true */ url);
+        const service = mod.default ?? mod.PlatformComponentService;
+        if (service) {
+            globalThis.PlatformComponentService = service;
+            logger.info('PlatformComponentService resolved from dynamic import');
+        }
+        else {
+            throw new Error('Imported module does not export PlatformComponentService');
+        }
+    }
+    catch (err) {
+        if (err instanceof Error && err.message === 'Imported module does not export PlatformComponentService') {
+            throw err;
+        }
+        throw new Error(`Failed to dynamically import platform connector from "${url}": ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=PlatformScriptLoader.js.map

package/dist/core/platform/PlatformScriptLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformScriptLoader.js","sourceRoot":"","sources":["../../../src/core/platform/PlatformScriptLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,MAAM,aAAa,GAA2B;IAC5C,GAAG,EAAE,8BAA8B;IACnC,EAAE,EAAE,6BAA6B;IACjC,IAAI,EAAE,8BAA8B;IACpC,KAAK,EAAE,uCAAuC;IAC9C,MAAM,EAAE,2BAA2B;IACnC,OAAO,EAAE,oCAAoC;IAC7C,KAAK,EAAE,6BAA6B;CACrC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAe,EAAE,WAAoB;IACrE,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;QACtC,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM;YAAE,OAAO,GAAG,CAAC;IAClE,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7D,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IAC5D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,WAAmB;IAC1E,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC;IACjE,OAAO,GAAG,OAAO,sBAAsB,QAAQ,mCAAmC,CAAC;AACrF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAkC;IACzE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3D,MAAM,SAAS,GAAG,WAAW,IAAI,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE3E,MAAM,SAAS,GAAG,OAAO,QAAQ,KAAK,WAAW,CAAC;IAElD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,oBAAoB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,MAAM,oBAAoB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,GAAW,EACX,MAA2C;IAE3C,MAAM,CAAC,IAAI,CAAC,oDAAoD,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAE3E,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;QACjB,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC;QAEjC,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE;YACnB,UAAU,CAAC,GAAG,EAAE;gBACd,IAAK,MAAc,CAAC,wBAAwB,EAAE,CAAC;oBAC7C,MAAM,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;oBAChE,OAAO,EAAE,CAAC;gBACZ,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,KAAK,CACd,0CAA0C,GAAG,0DAA0D,CACxG,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,EAAE,GAAG,CAAC,CAAC;QACV,CAAC,CAAC;QAEF,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE;YACpB,MAAM,CAAC,IAAI,KAAK,CAAC,kDAAkD,GAAG,GAAG,CAAC,CAAC,CAAC;QAC9E,CAAC,CAAC;QAEF,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,GAAW,EACX,MAA2C;IAE3C,MAAM,CAAC,IAAI,CAAC,wDAAwD,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAE/E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC;QACxD,MAAM,OAAO,GACX,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,wBAAwB,CAAC;QAE9C,IAAI,OAAO,EAAE,CAAC;YACX,UAAkB,CAAC,wBAAwB,GAAG,OAAO,CAAC;YACvD,MAAM,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,KAAK,0DAA0D,EAAE,CAAC;YACvG,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,MAAM,IAAI,KAAK,CACb,yDAAyD,GAAG,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACrH,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/core/polyfills.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Automatic polyfill detection and setup for Node.js environments
+ *
+ * This module automatically detects the runtime environment and sets up
+ * necessary polyfills for WebSocket and fetch when running in Node.js.
+ *
+ * In browser environments, native WebSocket and fetch are used.
+ * In Node.js environments, it attempts to load 'ws' for WebSocket and
+ * 'node-fetch' for fetch (if Node version < 18).
+ */
+/**
+ * Initialize polyfills automatically
+ * This function is called when the SDK is imported
+ */
+export declare function initializePolyfills(): void;
+//# sourceMappingURL=polyfills.d.ts.map

package/dist/core/polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfills.d.ts","sourceRoot":"","sources":["../../src/core/polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+JH;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}

package/dist/core/polyfills.js

@@ -0,0 +1,168 @@
+/**
+ * Automatic polyfill detection and setup for Node.js environments
+ *
+ * This module automatically detects the runtime environment and sets up
+ * necessary polyfills for WebSocket and fetch when running in Node.js.
+ *
+ * In browser environments, native WebSocket and fetch are used.
+ * In Node.js environments, it attempts to load 'ws' for WebSocket and
+ * 'node-fetch' for fetch (if Node version < 18).
+ */
+/**
+ * Check if we're running in a Node.js environment
+ */
+function isNodeEnvironment() {
+    return (typeof process !== 'undefined' &&
+        process.versions != null &&
+        process.versions.node != null &&
+        typeof window === 'undefined');
+}
+/**
+ * Get a require function for loading CommonJS modules in ES module context
+ * Works in both CommonJS and ES module environments
+ */
+function getRequire() {
+    if (!isNodeEnvironment()) {
+        return null;
+    }
+    try {
+        // In ES modules, we need to use createRequire from 'module'
+        // However, we can't synchronously import in ES modules
+        // So we use a workaround: try to access require via different methods
+        // Method 1: Try CommonJS require (if we're in a CommonJS context)
+        if (typeof require !== 'undefined' && typeof require === 'function') {
+            try {
+                const Module = require('module');
+                if (Module && Module.createRequire) {
+                    return Module.createRequire(import.meta.url);
+                }
+                // If createRequire not available, use require directly (CommonJS)
+                return require;
+            }
+            catch {
+                // module not available, but require might still work
+                return require;
+            }
+        }
+        // Method 2: Try global require (some environments expose this)
+        if (typeof globalThis.require === 'function') {
+            try {
+                const Module = globalThis.require('module');
+                if (Module && Module.createRequire) {
+                    return Module.createRequire(import.meta.url);
+                }
+                return globalThis.require;
+            }
+            catch {
+                return globalThis.require;
+            }
+        }
+        // Method 3: Try to use createRequire via Function constructor (works in Node.js)
+        // This is a workaround for ES modules where require is not directly available
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-implied-eval
+            const requireFn = new Function('return require')();
+            if (typeof requireFn === 'function') {
+                const Module = requireFn('module');
+                if (Module && Module.createRequire) {
+                    return Module.createRequire(import.meta.url);
+                }
+                return requireFn;
+            }
+        }
+        catch {
+            // Function constructor approach failed
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Setup WebSocket polyfill for Node.js
+ * Attempts to load 'ws' package and assign it to global.WebSocket
+ */
+function setupWebSocketPolyfill() {
+    // Only setup in Node.js environment
+    if (!isNodeEnvironment()) {
+        return;
+    }
+    // Check if WebSocket is already available globally
+    if (typeof globalThis.WebSocket !== 'undefined') {
+        return;
+    }
+    const requireFn = getRequire();
+    if (!requireFn) {
+        // Can't load polyfill automatically - this is OK, user can set it up manually
+        // We don't warn here because the SDK might be bundled and this is expected
+        return;
+    }
+    try {
+        const ws = requireFn('ws');
+        if (ws && ws.default) {
+            // Handle ES module default export
+            globalThis.WebSocket = ws.default;
+        }
+        else if (ws) {
+            // Handle CommonJS export
+            globalThis.WebSocket = ws;
+        }
+    }
+    catch (error) {
+        // 'ws' package not available - this is expected in browser builds
+        // In Node.js, users should install 'ws' as a peer dependency
+        // We don't warn here to avoid noise - the error will be clear when WebSocket is used
+    }
+}
+/**
+ * Setup fetch polyfill for Node.js (only needed for Node < 18)
+ * Attempts to load 'node-fetch' package and assign it to global.fetch
+ */
+function setupFetchPolyfill() {
+    // Only setup in Node.js environment
+    if (!isNodeEnvironment()) {
+        return;
+    }
+    // Check if fetch is already available globally
+    if (typeof globalThis.fetch !== 'undefined') {
+        return;
+    }
+    // Node.js 18+ has native fetch, so we only need polyfill for older versions
+    const nodeVersion = process.versions.node;
+    const majorVersion = parseInt(nodeVersion.split('.')[0], 10);
+    // For Node 18+, native fetch should be available
+    if (majorVersion >= 18) {
+        return;
+    }
+    const requireFn = getRequire();
+    if (!requireFn) {
+        // Can't load polyfill automatically
+        return;
+    }
+    try {
+        const nodeFetch = requireFn('node-fetch');
+        if (nodeFetch && nodeFetch.default) {
+            globalThis.fetch = nodeFetch.default;
+        }
+        else if (nodeFetch) {
+            globalThis.fetch = nodeFetch;
+        }
+    }
+    catch (error) {
+        // node-fetch not available - this is OK for Node 18+, but needed for < 18
+        // Error will be clear when fetch is used
+    }
+}
+/**
+ * Initialize polyfills automatically
+ * This function is called when the SDK is imported
+ */
+export function initializePolyfills() {
+    setupWebSocketPolyfill();
+    setupFetchPolyfill();
+}
+// Auto-initialize polyfills when this module is imported
+// This ensures polyfills are set up before any SDK code runs
+initializePolyfills();
+//# sourceMappingURL=polyfills.js.map

package/dist/core/polyfills.js.map

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

package/dist/core/portal-initializer/PortalInitializer.d.ts

@@ -0,0 +1,234 @@
+/**
+ * PortalInitializer — Event-driven chained pipeline for portal-based agent initialization
+ *
+ * Uses a chained architecture where each step either auto-selects and calls
+ * the next method directly, or emits an event and returns. The pipeline
+ * progresses via direct method calls triggered by the consumer's selection
+ * methods on AiAgent (selectPortal, selectAgent, selectUserProfile).
+ *
+ * Chain: start() → fetchPortals() → handleSelectedPortal() → handleSelectedAgent() → completeInitialization()
+ *
+ * Public handler methods: onPortalSelected(), onAgentSelected(), onProfileSelected()
+ *
+ * The pipeline has zero WebSocket knowledge — it is pure REST. The consumer
+ * calls connect() after receiving the initialized event.
+ *
+ * **cc-widget customer parity** (`agentDetails.userType === 'customer'` with non-empty `agentDetails.portals`):
+ * portal list is built only from those IDs (no myportals / portalIds / intersection / PCS / Flow B list filter).
+ * When `userType === 'customer'` or `initParams.authType === 'customer'`, skips GET userprofiles and may set
+ * profiles from `portalDetails.portal[0].portalSettings.defaultUserProfile` only. PUT `.../userprofiles/.../select`
+ * runs only for `userType === 'agent'`, `authType === 'user'`, or legacy unset typing (defaults to persist).
+ *
+ * @module PortalInitializer
+ */
+import type { CacheAdapter } from "../api/CacheAdapter.js";
+import type { Portal, UserProfile, AgentListItem } from "../types/PortalTypes.js";
+import type { PlatformComponentService } from "../platform/PlatformComponentService.js";
+import type { HookContract } from "../platform/HookContract.js";
+/**
+ * Configuration for PortalInitializer (injected dependencies).
+ * Pipeline has zero WebSocket knowledge; portal details and agents are always re-fetched via API (not cached).
+ */
+export interface PortalInitializerConfig {
+    agentId: string;
+    apiHelper: {
+        getMyPortals: (options: any) => Promise<Portal[]>;
+        getPortalDetails?: (options: any) => Promise<any>;
+        getAgentsByPortal: (options: any) => Promise<AgentListItem[]>;
+        getUserProfiles: (options: any) => Promise<UserProfile[]>;
+        selectUserProfile: (options: any) => Promise<void>;
+    };
+    logger: {
+        debug: (msg: string, ctx?: object) => void;
+        info: (msg: string, ctx?: object) => void;
+        warn: (msg: string, ctx?: object) => void;
+        error: (msg: string, err?: Error, ctx?: object) => void;
+        createChild: (name: string) => any;
+    };
+    authService: {
+        getToken: () => Promise<string | null>;
+    };
+    initParams: Record<string, string>;
+    /**
+     * Event emission function. AiAgent injects its own emit here and performs
+     * bookkeeping (setting resolvedAgentId, caching, isInitialized) when
+     * type === 'initialized'.
+     */
+    emit: (eventType: string, event: any) => void;
+    createAgentEventResponse: (type: string, payload: any) => any;
+    /**
+     * Optional cache adapter for profiles list reused on restart (portal-scoped).
+     * Portals are always fetched fresh from the API. Portal details and agents are also never cached.
+     */
+    pipelineCache?: {
+        adapter: CacheAdapter;
+        /** Returns the profiles cache key scoped to the given portalId. */
+        profilesKey: (portalId: string | number) => string;
+        /** Time-to-live in ms. Cached entries older than this are discarded on read. */
+        ttl?: number;
+    };
+    isAgentSelectionMode: boolean;
+    /**
+     * Agent details stored on the agent (e.g. AiAgent's agentDetails).
+     * - `languageCode` — forwarded to portalmgr portal list API (`getMyPortals`) as `$lang`.
+     * - `departmentId` — Flow B: filters portals by `portal.department.id` (cc-widget: from default agent API details). `initParams.departmentId` is fallback only.
+     * - `portals` — used for user/agent portal intersection when `initParams.agentid` is set and not in Flow B; for `userType === 'customer'` with a non-empty list, used as the sole portal list (cc-widget parity).
+     * - `userType` — `'customer'` enables cc-widget customer portal list, profile, and select-API behavior.
+     */
+    agentDetails?: {
+        languageCode?: string;
+        departmentId?: string | number;
+        portals?: Array<string | number | {
+            id?: string | number;
+        }>;
+        userType?: "agent" | "customer";
+    };
+    /**
+     * Platform component service (from loaded connector script).
+     * When present, the pipeline calls portal-related hooks during execution.
+     */
+    platformComponentService?: PlatformComponentService;
+    /**
+     * HookContract instance (built by AiAgent). Needed so that onPortalSelected
+     * can store filter tags via setUserFilterTags.
+     */
+    hookContract?: HookContract;
+}
+/**
+ * Event-driven chained pipeline for the CC widget initialization flow.
+ *
+ * Each step auto-selects (count == 1) and calls the next method directly,
+ * or emits an event and returns. The consumer's selection call triggers the
+ * next step — no await gates.
+ *
+ * Supports Flow A (specific agent: portal → profile) and Flow B (default agent: portal → agent → profile).
+ */
+export declare class PortalInitializer {
+    private deps;
+    private portals;
+    private selectedPortal?;
+    private portalDetails?;
+    private profiles;
+    private agents;
+    private selectedAgent?;
+    private selectedProfile?;
+    private destroyed;
+    constructor(deps: PortalInitializerConfig);
+    private readCachedFromAdapter;
+    /**
+     * Start the pipeline. Performs pre-flight (token acquisition, portal-selection
+     * requirement check) and kicks off fetchPortals() when needed.
+     *
+     * Per the architecture diagram, start() checks queryParam.isDefaultAgent:
+     *  - True  → fetchPortals() (Flow B)
+     *  - False → fetchPortals() (Flow A); portal list may be narrowed via `agentid` + `agentDetails.portals` like cc-widget
+     */
+    start(): Promise<void>;
+    /**
+     * Fetch portals (once), apply mode-specific filtering, then auto-select or emit.
+     *
+     * Mirrors cc-widget's `getFilteredPortals`: resolve the portal list first
+     * (customer synthetic / portalIds / API), then branch on mode for filtering.
+     * Customer synthetic path skips filtering entirely.
+     */
+    private fetchPortals;
+    /**
+     * Flow A filter: intersect user portals with the specific agent's portal list
+     * (when `initParams.agentid` is set), then run PCS hooks.
+     */
+    private filterAgentSpecificPortals;
+    /**
+     * Flow B filter: run PCS hooks, then narrow portals to those whose department
+     * matches the resolved `departmentId` (from agentDetails or initParams).
+     */
+    private filterDepartmentSpecificPortals;
+    /**
+     * Run PCS getPortalList and getDefaultPortal hooks on the portal list.
+     * Errors cause the portal list to be cleared (cc-widget callPortalWebhook parity).
+     */
+    private applyPcsHooks;
+    /**
+     * Validate that the portal list is non-empty, store it, then either
+     * auto-select (single portal) or emit portalsAvailable for the consumer.
+     */
+    private emitPortalsAvailable;
+    /**
+     * Process the selected portal: resolve portal details + profiles, enrich
+     * the portal name, then branch to agent selection (Flow B) or profile
+     * resolution (Flow A).
+     */
+    private handleSelectedPortal;
+    /** Fetch portal details from API. Swallows errors and returns undefined on failure. */
+    private fetchPortalDetails;
+    /** Cache-hit strategy: return cached profiles with fresh portal details, or null if cache miss. */
+    private resolveProfilesFromCache;
+    /**
+     * Customer strategy: fetch portal details only (skip getUserProfiles),
+     * extract defaultUserProfile from portal settings if present.
+     */
+    private resolveProfilesForCustomer;
+    /** Normal strategy: fetch portal details and user profiles in parallel. */
+    private resolveProfilesFromApi;
+    /**
+     * Extract the default user profile from portal details for customer mode.
+     * Returns a single-element array if a valid default exists, otherwise empty.
+     */
+    private extractCustomerProfileFromDetails;
+    /**
+     * Enrich `selectedPortal.name` and the matching `portals[]` entry from
+     * the portal details API response (cc-widget portalService.handlePortalSelection parity).
+     */
+    private addPortalName;
+    /**
+     * Flow B: validate departmentId, fetch agents for the selected portal,
+     * then auto-select (single agent) or emit agentsAvailable.
+     */
+    private fetchAndEmitAgents;
+    /**
+     * Process the selected agent (or no agent in Flow A): resolve profile selection
+     * using priority logic, then chain to completeInitialization or emit profilesAvailable.
+     */
+    private handleSelectedAgent;
+    /**
+     * Priority cascade for auto-selecting a profile.
+     * Returns `{ profile }` when one can be auto-selected (including `undefined`
+     * for the zero-profiles case), or `null` when the consumer must choose.
+     *
+     * Priority: no profiles → single → lastUsed → portalDefault → null (emit)
+     */
+    private resolveAutoProfile;
+    /** Extract the default profile ID from the two possible portal details shapes. */
+    private getDefaultProfileFromPortal;
+    /**
+     * Final pipeline step: persist profile selection and emit the initialized event
+     * with the full payload built from instance fields.
+     */
+    private completeInitialization;
+    /**
+     * Call PCS.onPortalSelected() and store filter tags if returned.
+     * Best-effort: errors are logged as warnings and filter tags default to {}.
+     */
+    private callOnPortalSelected;
+    /**
+     * Called by AiAgent.selectPortal(). Stores the selected portal and triggers
+     * the next pipeline step (handleSelectedPortal).
+     */
+    onPortalSelected(portal: Portal): void;
+    /**
+     * Called by AiAgent.selectAgent(). Stores the selected agent and triggers
+     * the next pipeline step (handleSelectedAgent). Flow B only.
+     */
+    onAgentSelected(agent: AgentListItem): void;
+    /**
+     * Called by AiAgent.selectUserProfile(). Stores the selected profile and triggers
+     * the final pipeline step (completeInitialization).
+     */
+    onProfileSelected(profile: UserProfile): void;
+    /**
+     * Destroy the pipeline. Sets a destroyed flag so that any in-progress or
+     * future chained method calls are no-ops. After calling destroy(), the
+     * pipeline instance must not be reused.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=PortalInitializer.d.ts.map

package/dist/core/portal-initializer/PortalInitializer.d.ts.map

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