@onlive.ai/common-121 0.2.179 → 0.2.187

package/index.d.cts

@@ -1,4 +1,4 @@
-/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+/*! @onlive.ai/common-121 v0.2.187 | © 2026 Onlive.ai */
 import * as lit from 'lit';
 import { LitElement, TemplateResult } from 'lit';
 import * as _lit_react from '@lit/react';
@@ -6,7 +6,7 @@ import { EventName } from '@lit/react';
 import { Room as Room$1, Participant } from 'livekit-client';
 import { ReceivedChatMessage } from '@livekit/components-core';
 
-/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+/*! @onlive.ai/common-121 v0.2.187 | © 2026 Onlive.ai */
 
 
 type AssetType = "product" | "multimedia" | "faq" | "file";
@@ -1464,6 +1464,60 @@ type CreateRoomOptions = {
     userGroupId?: string;
     initialMessage?: string;
 };
+/**
+ * Options for the unified quick-start endpoint that combines user registration
+ * and room creation in a single HTTP call.
+ *
+ * @property {Object} user - User registration data.
+ * @property {string} user.externalId - External user identifier.
+ * @property {string} user.secret - User authentication secret.
+ * @property {string} [user.name] - User display name.
+ * @property {string} [user.email] - User email address.
+ * @property {string} [user.phone] - User phone number.
+ * @property {string} [user.avatar] - URL of the user's avatar.
+ * @property {Record<string, unknown>} [user.metadata] - Additional user metadata.
+ * @property {string | null} [user.userGroupId] - User group identifier.
+ * @property {string} [user.sessionId] - External session identifier.
+ * @property {Object} room - Room creation data.
+ * @property {string} room.language - Preferred language code (e.g., "en", "es").
+ * @property {string} room.timezone - IANA timezone identifier.
+ * @property {Record<string, unknown>} [room.affinity] - Agent affinity preferences.
+ * @property {string} [room.name] - Room display name.
+ * @property {string} [room.platformType] - Platform type (default: "web").
+ * @property {Record<string, unknown>} [room.metadata] - Additional room metadata.
+ * @property {string | null} [room.userGroupId] - Room user group identifier.
+ * @property {boolean} [room.disablePersistence] - Disable message persistence.
+ * @property {ContextualEvent[]} [room.contextualEvents] - Initial contextual events.
+ * @property {{ content: string; assets?: unknown[] }} [room.initialMessage] - Initial message to include in the room.
+ */
+type QuickStartOptions = {
+    user: {
+        externalId: string;
+        secret: string;
+        name?: string;
+        email?: string;
+        phone?: string;
+        avatar?: string;
+        metadata?: Record<string, unknown>;
+        userGroupId?: string | null;
+        sessionId?: string;
+    };
+    room: {
+        language: string;
+        timezone: string;
+        affinity?: Record<string, unknown>;
+        name?: string;
+        platformType?: string;
+        metadata?: Record<string, unknown>;
+        userGroupId?: string | null;
+        disablePersistence?: boolean;
+        contextualEvents?: ContextualEvent[];
+        initialMessage?: {
+            content: string;
+            assets?: unknown[];
+        };
+    };
+};
 /**
  * Options for fetching messages.
  *
@@ -1776,6 +1830,19 @@ declare class ConversationService {
      * @returns {{ username?: string; sub?: string; iat?: number; exp?: number } | null} Decoded payload or null if invalid.
      */
     private decodeJwtPayload;
+    /**
+     * Performs a unified user registration and room creation in a single HTTP call.
+     *
+     * This method combines the `registerUser` and `createRoom` steps into one request,
+     * reducing latency by eliminating the intermediate round-trip and JWT authentication overhead.
+     * It does not require a prior authentication token — only the organization header.
+     *
+     * @async
+     * @param {QuickStartOptions} options - Combined user and room options.
+     * @returns {Promise<Room>} Connected room instance ready for messaging.
+     * @throws {Error} If the quick-start request fails or returns invalid data.
+     */
+    quickStart(options: QuickStartOptions): Promise<Room>;
     /**
      * Creates a new conversation room.
      *
@@ -3436,6 +3503,11 @@ declare class MockConversationService {
      * Registers an agent for handling conversations.
      */
     registerAgent(externalId: string, agentData: AgentData): Promise<string>;
+    /**
+     * Mock implementation of the unified quick-start endpoint.
+     * Combines registerUser and createRoom into a single call.
+     */
+    quickStart(options: QuickStartOptions): Promise<MockRoom>;
     /**
      * Creates a new conversation room.
      */
@@ -4394,4 +4466,107 @@ declare const MockServiceActions: {
     getRoom(): MockRoom;
 };
 
-export { AgentNotFoundError, Asset, type AssetDisplayOptions, type AssetItemDisplayOptions, ConversationServiceFactory, type ConversationServiceFactoryOptions, InvalidOperationError, type LiveKitMode, type MockAgentConfig, type MockAgentMessage, type MockAgentMessageEvent, type MockAgentResponseStrategy, type MockAgentStartedEvent, type MockAgentState, type MockAgentStatus, type MockAgentStoppedEvent, type MockConnectionState$1 as MockConnectionState, MockConversationService, type MockDataReceivedEvent, type MockError, type MockErrorCode, type MockErrorConfig, type MockErrorEvent, type MockEvent, type MockEventBase, MockEventEmitter, type MockEventListener, type MockEventListenerMap, type MockEventType, MockLiveKitError, MockLocalParticipant, type MockMessageReceivedEvent, type MockMessageSentEvent, type MockMessageState, MockParticipant, type MockParticipantAttributesChangedEvent, type MockParticipantJoinedEvent, type MockParticipantKind$1 as MockParticipantKind, type MockParticipantLeftEvent, type MockParticipantRole, type MockParticipantState, MockRoom, type MockRoomConnectionStateChangedEvent, type MockRoomCreatedEvent, type MockRoomEndedEvent, type MockRoomState, type MockScenario, MockServiceActions, type MockServiceConfig, type MockServiceDecoratorConfig, MockState, type MockStateSnapshot, type MockStateSnapshotJSON, MockTextStreamReader, MockTrack, type MockTrackKind, type MockTrackMutedEvent, MockTrackPublication, type MockTrackPublishedEvent, type MockTrackSource, type MockTrackState, type MockTrackUnmutedEvent, type MockTrackUnpublishedEvent, type MockTypingIndicatorEvent, NetworkError, OSBAsset, OSBSideBar, OSBUpload, ParticipantAlreadyJoinedError, ParticipantNotFoundError, RoomEndedError, RoomNotFoundError, SYNTHETIC_MEDIA_PRESETS, SideBar, StorybookScenarios, type SyntheticAudioConfig, type SyntheticVideoConfig, TimeoutError, TrackNotFoundError, UnauthorizedError, Upload, type UploadConfig, createAgentFixture, createAgentWithCannedResponses, createChatScenario, createConversationFixture, createConversationService, createDefaultConfig, createDefaultRoomFixture, createDeterministicConfig, createErrorFromMockError, createLatencyConfig, createMessageFixture, createMockConversationService, createMockServiceFactory, createParticipantBatch, createParticipantFixture, createRoomWithAgent, createRoomWithAgentAndDataTrack, createRoomWithLocalParticipant, createRoomWithMediaTracks, createRoomWithTwoParticipants, createSequentialAgent, createStrictConfig, createSyntheticAudioTrack, createSyntheticMedia, createSyntheticMediaFromPreset, createSyntheticVideoTrack, createVideoCallScenario, decodeMockToken, destroyStorybookMockService, generateMockApiResponseId, generateMockExternalId, generateMockId, generateMockIdBatch, generateMockMessageId, generateMockParticipantIdentity, generateMockRoomName, generateMockToken, generateMockTrackSid, generateMockWsUrl, generateSeededMockId, getStorybookMockService, isMockConversationService, isMockError, isMockLiveKitError, resetIdCounter, resetStorybookMockService, setIdCounter, withMockConversationService };
+/**
+ * Supported deep link actions that can be triggered via URL parameters.
+ *
+ * @property {"openWidget"} openWidget - Opens the widget automatically, as if the user clicked on it.
+ * @property {"initialStep"} initialStep - Starts the flow at a specific step identified by `olStepId`.
+ */
+declare const DeepLinkAction: {
+    readonly OpenWidget: "openWidget";
+    readonly InitialStep: "initialStep";
+};
+/**
+ * Union type of all valid deep link action values.
+ */
+type DeepLinkAction = (typeof DeepLinkAction)[keyof typeof DeepLinkAction];
+/**
+ * Parsed deep link parameters extracted from URL query strings.
+ * All parameters use the `ol` prefix in the URL (e.g., `?olAction=openWidget`).
+ *
+ * @property {DeepLinkAction} [action] - The deep link action to execute (e.g., "openWidget", "initialStep").
+ * @property {string} [message] - Initial message to send when creating a chat room.
+ * @property {string} [stepId] - Identifier of the flow step to start from, used with `initialStep` action.
+ * @property {string} [installationId] - Installation identifier to filter which widget instance should process the deep link.
+ */
+type DeepLinkParams = {
+    action?: DeepLinkAction;
+    message?: string;
+    stepId?: string;
+    installationId?: string;
+};
+
+/**
+ * @summary A service to parse and manage deep link parameters from URL query strings.
+ *
+ * @description
+ * Extracts Onlive-specific deep link parameters (prefixed with `ol`) from the
+ * current page URL. Provides methods to check whether the deep link targets a
+ * specific widget installation, retrieve individual parameters, and clean up
+ * the URL after the deep link has been processed.
+ *
+ * Deep link parameters follow the convention `ol<ParamName>`:
+ * - `olAction` — The action to perform (e.g., `openWidget`, `initialStep`).
+ * - `olMessage` — An initial message for room creation.
+ * - `olStepId` — A flow step identifier to start from.
+ * - `olInstallationId` — Filters which widget installation should process the link.
+ */
+declare class DeepLinkService {
+    /**
+     * Parsed deep link parameters extracted from the URL.
+     *
+     * @private
+     * @type {DeepLinkParams}
+     */
+    private readonly params;
+    /**
+     * Initializes the service by parsing deep link parameters from the current URL.
+     */
+    constructor();
+    /**
+     * Whether the current URL contains any valid deep link parameters.
+     *
+     * @returns {boolean} `true` if at least one deep link parameter was found.
+     */
+    get hasParams(): boolean;
+    /**
+     * Retrieves all parsed deep link parameters.
+     *
+     * @returns {DeepLinkParams} A shallow copy of the parsed parameters.
+     */
+    getParams(): DeepLinkParams;
+    /**
+     * Checks whether the deep link targets a specific widget installation.
+     *
+     * When `olInstallationId` is present in the URL, only the widget whose
+     * `installationId` matches should process the deep link. When the parameter
+     * is absent, the deep link applies to every widget on the page.
+     *
+     * @param {string} [widgetInstallationId] - The installation ID of the widget to check against.
+     * @returns {boolean} `true` if the deep link should be processed by this widget.
+     */
+    matchesInstallation(widgetInstallationId?: string): boolean;
+    /**
+     * Removes all Onlive deep link parameters from the browser URL without
+     * triggering a page reload. Non-Onlive parameters are preserved.
+     *
+     * This should be called after the deep link has been processed to prevent
+     * re-processing on page navigation or refresh.
+     */
+    cleanUrl(): void;
+    /**
+     * Parses deep link parameters from the current URL query string.
+     *
+     * Extracts parameters that:
+     * 1. Start with the `ol` prefix.
+     * 2. Have a known suffix defined in `PARAM_MAP`.
+     * 3. For `action`, the value must be one of the valid `DeepLinkAction` values.
+     *
+     * @private
+     * @static
+     * @returns {DeepLinkParams} The parsed parameters (empty object if none found).
+     */
+    private static parse;
+}
+
+export { AgentNotFoundError, Asset, type AssetDisplayOptions, type AssetItemDisplayOptions, ConversationServiceFactory, type ConversationServiceFactoryOptions, DeepLinkAction, type DeepLinkParams, DeepLinkService, InvalidOperationError, type LiveKitMode, type MockAgentConfig, type MockAgentMessage, type MockAgentMessageEvent, type MockAgentResponseStrategy, type MockAgentStartedEvent, type MockAgentState, type MockAgentStatus, type MockAgentStoppedEvent, type MockConnectionState$1 as MockConnectionState, MockConversationService, type MockDataReceivedEvent, type MockError, type MockErrorCode, type MockErrorConfig, type MockErrorEvent, type MockEvent, type MockEventBase, MockEventEmitter, type MockEventListener, type MockEventListenerMap, type MockEventType, MockLiveKitError, MockLocalParticipant, type MockMessageReceivedEvent, type MockMessageSentEvent, type MockMessageState, MockParticipant, type MockParticipantAttributesChangedEvent, type MockParticipantJoinedEvent, type MockParticipantKind$1 as MockParticipantKind, type MockParticipantLeftEvent, type MockParticipantRole, type MockParticipantState, MockRoom, type MockRoomConnectionStateChangedEvent, type MockRoomCreatedEvent, type MockRoomEndedEvent, type MockRoomState, type MockScenario, MockServiceActions, type MockServiceConfig, type MockServiceDecoratorConfig, MockState, type MockStateSnapshot, type MockStateSnapshotJSON, MockTextStreamReader, MockTrack, type MockTrackKind, type MockTrackMutedEvent, MockTrackPublication, type MockTrackPublishedEvent, type MockTrackSource, type MockTrackState, type MockTrackUnmutedEvent, type MockTrackUnpublishedEvent, type MockTypingIndicatorEvent, NetworkError, OSBAsset, OSBSideBar, OSBUpload, ParticipantAlreadyJoinedError, ParticipantNotFoundError, RoomEndedError, RoomNotFoundError, SYNTHETIC_MEDIA_PRESETS, SideBar, StorybookScenarios, type SyntheticAudioConfig, type SyntheticVideoConfig, TimeoutError, TrackNotFoundError, UnauthorizedError, Upload, type UploadConfig, createAgentFixture, createAgentWithCannedResponses, createChatScenario, createConversationFixture, createConversationService, createDefaultConfig, createDefaultRoomFixture, createDeterministicConfig, createErrorFromMockError, createLatencyConfig, createMessageFixture, createMockConversationService, createMockServiceFactory, createParticipantBatch, createParticipantFixture, createRoomWithAgent, createRoomWithAgentAndDataTrack, createRoomWithLocalParticipant, createRoomWithMediaTracks, createRoomWithTwoParticipants, createSequentialAgent, createStrictConfig, createSyntheticAudioTrack, createSyntheticMedia, createSyntheticMediaFromPreset, createSyntheticVideoTrack, createVideoCallScenario, decodeMockToken, destroyStorybookMockService, generateMockApiResponseId, generateMockExternalId, generateMockId, generateMockIdBatch, generateMockMessageId, generateMockParticipantIdentity, generateMockRoomName, generateMockToken, generateMockTrackSid, generateMockWsUrl, generateSeededMockId, getStorybookMockService, isMockConversationService, isMockError, isMockLiveKitError, resetIdCounter, resetStorybookMockService, setIdCounter, withMockConversationService };

package/index.d.ts

@@ -1,4 +1,4 @@
-/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+/*! @onlive.ai/common-121 v0.2.187 | © 2026 Onlive.ai */
 import * as lit from 'lit';
 import { LitElement, TemplateResult } from 'lit';
 import * as _lit_react from '@lit/react';
@@ -6,7 +6,7 @@ import { EventName } from '@lit/react';
 import { Room as Room$1, Participant } from 'livekit-client';
 import { ReceivedChatMessage } from '@livekit/components-core';
 
-/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+/*! @onlive.ai/common-121 v0.2.187 | © 2026 Onlive.ai */
 
 
 type AssetType = "product" | "multimedia" | "faq" | "file";
@@ -1464,6 +1464,60 @@ type CreateRoomOptions = {
     userGroupId?: string;
     initialMessage?: string;
 };
+/**
+ * Options for the unified quick-start endpoint that combines user registration
+ * and room creation in a single HTTP call.
+ *
+ * @property {Object} user - User registration data.
+ * @property {string} user.externalId - External user identifier.
+ * @property {string} user.secret - User authentication secret.
+ * @property {string} [user.name] - User display name.
+ * @property {string} [user.email] - User email address.
+ * @property {string} [user.phone] - User phone number.
+ * @property {string} [user.avatar] - URL of the user's avatar.
+ * @property {Record<string, unknown>} [user.metadata] - Additional user metadata.
+ * @property {string | null} [user.userGroupId] - User group identifier.
+ * @property {string} [user.sessionId] - External session identifier.
+ * @property {Object} room - Room creation data.
+ * @property {string} room.language - Preferred language code (e.g., "en", "es").
+ * @property {string} room.timezone - IANA timezone identifier.
+ * @property {Record<string, unknown>} [room.affinity] - Agent affinity preferences.
+ * @property {string} [room.name] - Room display name.
+ * @property {string} [room.platformType] - Platform type (default: "web").
+ * @property {Record<string, unknown>} [room.metadata] - Additional room metadata.
+ * @property {string | null} [room.userGroupId] - Room user group identifier.
+ * @property {boolean} [room.disablePersistence] - Disable message persistence.
+ * @property {ContextualEvent[]} [room.contextualEvents] - Initial contextual events.
+ * @property {{ content: string; assets?: unknown[] }} [room.initialMessage] - Initial message to include in the room.
+ */
+type QuickStartOptions = {
+    user: {
+        externalId: string;
+        secret: string;
+        name?: string;
+        email?: string;
+        phone?: string;
+        avatar?: string;
+        metadata?: Record<string, unknown>;
+        userGroupId?: string | null;
+        sessionId?: string;
+    };
+    room: {
+        language: string;
+        timezone: string;
+        affinity?: Record<string, unknown>;
+        name?: string;
+        platformType?: string;
+        metadata?: Record<string, unknown>;
+        userGroupId?: string | null;
+        disablePersistence?: boolean;
+        contextualEvents?: ContextualEvent[];
+        initialMessage?: {
+            content: string;
+            assets?: unknown[];
+        };
+    };
+};
 /**
  * Options for fetching messages.
  *
@@ -1776,6 +1830,19 @@ declare class ConversationService {
      * @returns {{ username?: string; sub?: string; iat?: number; exp?: number } | null} Decoded payload or null if invalid.
      */
     private decodeJwtPayload;
+    /**
+     * Performs a unified user registration and room creation in a single HTTP call.
+     *
+     * This method combines the `registerUser` and `createRoom` steps into one request,
+     * reducing latency by eliminating the intermediate round-trip and JWT authentication overhead.
+     * It does not require a prior authentication token — only the organization header.
+     *
+     * @async
+     * @param {QuickStartOptions} options - Combined user and room options.
+     * @returns {Promise<Room>} Connected room instance ready for messaging.
+     * @throws {Error} If the quick-start request fails or returns invalid data.
+     */
+    quickStart(options: QuickStartOptions): Promise<Room>;
     /**
      * Creates a new conversation room.
      *
@@ -3436,6 +3503,11 @@ declare class MockConversationService {
      * Registers an agent for handling conversations.
      */
     registerAgent(externalId: string, agentData: AgentData): Promise<string>;
+    /**
+     * Mock implementation of the unified quick-start endpoint.
+     * Combines registerUser and createRoom into a single call.
+     */
+    quickStart(options: QuickStartOptions): Promise<MockRoom>;
     /**
      * Creates a new conversation room.
      */
@@ -4394,4 +4466,107 @@ declare const MockServiceActions: {
     getRoom(): MockRoom;
 };
 
-export { AgentNotFoundError, Asset, type AssetDisplayOptions, type AssetItemDisplayOptions, ConversationServiceFactory, type ConversationServiceFactoryOptions, InvalidOperationError, type LiveKitMode, type MockAgentConfig, type MockAgentMessage, type MockAgentMessageEvent, type MockAgentResponseStrategy, type MockAgentStartedEvent, type MockAgentState, type MockAgentStatus, type MockAgentStoppedEvent, type MockConnectionState$1 as MockConnectionState, MockConversationService, type MockDataReceivedEvent, type MockError, type MockErrorCode, type MockErrorConfig, type MockErrorEvent, type MockEvent, type MockEventBase, MockEventEmitter, type MockEventListener, type MockEventListenerMap, type MockEventType, MockLiveKitError, MockLocalParticipant, type MockMessageReceivedEvent, type MockMessageSentEvent, type MockMessageState, MockParticipant, type MockParticipantAttributesChangedEvent, type MockParticipantJoinedEvent, type MockParticipantKind$1 as MockParticipantKind, type MockParticipantLeftEvent, type MockParticipantRole, type MockParticipantState, MockRoom, type MockRoomConnectionStateChangedEvent, type MockRoomCreatedEvent, type MockRoomEndedEvent, type MockRoomState, type MockScenario, MockServiceActions, type MockServiceConfig, type MockServiceDecoratorConfig, MockState, type MockStateSnapshot, type MockStateSnapshotJSON, MockTextStreamReader, MockTrack, type MockTrackKind, type MockTrackMutedEvent, MockTrackPublication, type MockTrackPublishedEvent, type MockTrackSource, type MockTrackState, type MockTrackUnmutedEvent, type MockTrackUnpublishedEvent, type MockTypingIndicatorEvent, NetworkError, OSBAsset, OSBSideBar, OSBUpload, ParticipantAlreadyJoinedError, ParticipantNotFoundError, RoomEndedError, RoomNotFoundError, SYNTHETIC_MEDIA_PRESETS, SideBar, StorybookScenarios, type SyntheticAudioConfig, type SyntheticVideoConfig, TimeoutError, TrackNotFoundError, UnauthorizedError, Upload, type UploadConfig, createAgentFixture, createAgentWithCannedResponses, createChatScenario, createConversationFixture, createConversationService, createDefaultConfig, createDefaultRoomFixture, createDeterministicConfig, createErrorFromMockError, createLatencyConfig, createMessageFixture, createMockConversationService, createMockServiceFactory, createParticipantBatch, createParticipantFixture, createRoomWithAgent, createRoomWithAgentAndDataTrack, createRoomWithLocalParticipant, createRoomWithMediaTracks, createRoomWithTwoParticipants, createSequentialAgent, createStrictConfig, createSyntheticAudioTrack, createSyntheticMedia, createSyntheticMediaFromPreset, createSyntheticVideoTrack, createVideoCallScenario, decodeMockToken, destroyStorybookMockService, generateMockApiResponseId, generateMockExternalId, generateMockId, generateMockIdBatch, generateMockMessageId, generateMockParticipantIdentity, generateMockRoomName, generateMockToken, generateMockTrackSid, generateMockWsUrl, generateSeededMockId, getStorybookMockService, isMockConversationService, isMockError, isMockLiveKitError, resetIdCounter, resetStorybookMockService, setIdCounter, withMockConversationService };
+/**
+ * Supported deep link actions that can be triggered via URL parameters.
+ *
+ * @property {"openWidget"} openWidget - Opens the widget automatically, as if the user clicked on it.
+ * @property {"initialStep"} initialStep - Starts the flow at a specific step identified by `olStepId`.
+ */
+declare const DeepLinkAction: {
+    readonly OpenWidget: "openWidget";
+    readonly InitialStep: "initialStep";
+};
+/**
+ * Union type of all valid deep link action values.
+ */
+type DeepLinkAction = (typeof DeepLinkAction)[keyof typeof DeepLinkAction];
+/**
+ * Parsed deep link parameters extracted from URL query strings.
+ * All parameters use the `ol` prefix in the URL (e.g., `?olAction=openWidget`).
+ *
+ * @property {DeepLinkAction} [action] - The deep link action to execute (e.g., "openWidget", "initialStep").
+ * @property {string} [message] - Initial message to send when creating a chat room.
+ * @property {string} [stepId] - Identifier of the flow step to start from, used with `initialStep` action.
+ * @property {string} [installationId] - Installation identifier to filter which widget instance should process the deep link.
+ */
+type DeepLinkParams = {
+    action?: DeepLinkAction;
+    message?: string;
+    stepId?: string;
+    installationId?: string;
+};
+
+/**
+ * @summary A service to parse and manage deep link parameters from URL query strings.
+ *
+ * @description
+ * Extracts Onlive-specific deep link parameters (prefixed with `ol`) from the
+ * current page URL. Provides methods to check whether the deep link targets a
+ * specific widget installation, retrieve individual parameters, and clean up
+ * the URL after the deep link has been processed.
+ *
+ * Deep link parameters follow the convention `ol<ParamName>`:
+ * - `olAction` — The action to perform (e.g., `openWidget`, `initialStep`).
+ * - `olMessage` — An initial message for room creation.
+ * - `olStepId` — A flow step identifier to start from.
+ * - `olInstallationId` — Filters which widget installation should process the link.
+ */
+declare class DeepLinkService {
+    /**
+     * Parsed deep link parameters extracted from the URL.
+     *
+     * @private
+     * @type {DeepLinkParams}
+     */
+    private readonly params;
+    /**
+     * Initializes the service by parsing deep link parameters from the current URL.
+     */
+    constructor();
+    /**
+     * Whether the current URL contains any valid deep link parameters.
+     *
+     * @returns {boolean} `true` if at least one deep link parameter was found.
+     */
+    get hasParams(): boolean;
+    /**
+     * Retrieves all parsed deep link parameters.
+     *
+     * @returns {DeepLinkParams} A shallow copy of the parsed parameters.
+     */
+    getParams(): DeepLinkParams;
+    /**
+     * Checks whether the deep link targets a specific widget installation.
+     *
+     * When `olInstallationId` is present in the URL, only the widget whose
+     * `installationId` matches should process the deep link. When the parameter
+     * is absent, the deep link applies to every widget on the page.
+     *
+     * @param {string} [widgetInstallationId] - The installation ID of the widget to check against.
+     * @returns {boolean} `true` if the deep link should be processed by this widget.
+     */
+    matchesInstallation(widgetInstallationId?: string): boolean;
+    /**
+     * Removes all Onlive deep link parameters from the browser URL without
+     * triggering a page reload. Non-Onlive parameters are preserved.
+     *
+     * This should be called after the deep link has been processed to prevent
+     * re-processing on page navigation or refresh.
+     */
+    cleanUrl(): void;
+    /**
+     * Parses deep link parameters from the current URL query string.
+     *
+     * Extracts parameters that:
+     * 1. Start with the `ol` prefix.
+     * 2. Have a known suffix defined in `PARAM_MAP`.
+     * 3. For `action`, the value must be one of the valid `DeepLinkAction` values.
+     *
+     * @private
+     * @static
+     * @returns {DeepLinkParams} The parsed parameters (empty object if none found).
+     */
+    private static parse;
+}
+
+export { AgentNotFoundError, Asset, type AssetDisplayOptions, type AssetItemDisplayOptions, ConversationServiceFactory, type ConversationServiceFactoryOptions, DeepLinkAction, type DeepLinkParams, DeepLinkService, InvalidOperationError, type LiveKitMode, type MockAgentConfig, type MockAgentMessage, type MockAgentMessageEvent, type MockAgentResponseStrategy, type MockAgentStartedEvent, type MockAgentState, type MockAgentStatus, type MockAgentStoppedEvent, type MockConnectionState$1 as MockConnectionState, MockConversationService, type MockDataReceivedEvent, type MockError, type MockErrorCode, type MockErrorConfig, type MockErrorEvent, type MockEvent, type MockEventBase, MockEventEmitter, type MockEventListener, type MockEventListenerMap, type MockEventType, MockLiveKitError, MockLocalParticipant, type MockMessageReceivedEvent, type MockMessageSentEvent, type MockMessageState, MockParticipant, type MockParticipantAttributesChangedEvent, type MockParticipantJoinedEvent, type MockParticipantKind$1 as MockParticipantKind, type MockParticipantLeftEvent, type MockParticipantRole, type MockParticipantState, MockRoom, type MockRoomConnectionStateChangedEvent, type MockRoomCreatedEvent, type MockRoomEndedEvent, type MockRoomState, type MockScenario, MockServiceActions, type MockServiceConfig, type MockServiceDecoratorConfig, MockState, type MockStateSnapshot, type MockStateSnapshotJSON, MockTextStreamReader, MockTrack, type MockTrackKind, type MockTrackMutedEvent, MockTrackPublication, type MockTrackPublishedEvent, type MockTrackSource, type MockTrackState, type MockTrackUnmutedEvent, type MockTrackUnpublishedEvent, type MockTypingIndicatorEvent, NetworkError, OSBAsset, OSBSideBar, OSBUpload, ParticipantAlreadyJoinedError, ParticipantNotFoundError, RoomEndedError, RoomNotFoundError, SYNTHETIC_MEDIA_PRESETS, SideBar, StorybookScenarios, type SyntheticAudioConfig, type SyntheticVideoConfig, TimeoutError, TrackNotFoundError, UnauthorizedError, Upload, type UploadConfig, createAgentFixture, createAgentWithCannedResponses, createChatScenario, createConversationFixture, createConversationService, createDefaultConfig, createDefaultRoomFixture, createDeterministicConfig, createErrorFromMockError, createLatencyConfig, createMessageFixture, createMockConversationService, createMockServiceFactory, createParticipantBatch, createParticipantFixture, createRoomWithAgent, createRoomWithAgentAndDataTrack, createRoomWithLocalParticipant, createRoomWithMediaTracks, createRoomWithTwoParticipants, createSequentialAgent, createStrictConfig, createSyntheticAudioTrack, createSyntheticMedia, createSyntheticMediaFromPreset, createSyntheticVideoTrack, createVideoCallScenario, decodeMockToken, destroyStorybookMockService, generateMockApiResponseId, generateMockExternalId, generateMockId, generateMockIdBatch, generateMockMessageId, generateMockParticipantIdentity, generateMockRoomName, generateMockToken, generateMockTrackSid, generateMockWsUrl, generateSeededMockId, getStorybookMockService, isMockConversationService, isMockError, isMockLiveKitError, resetIdCounter, resetStorybookMockService, setIdCounter, withMockConversationService };