@marketrix.ai/widget 3.8.142 → 3.8.144

package/dist/src/components/base/Card.d.ts

@@ -9,8 +9,4 @@ export interface CardProps extends React.HTMLAttributes<HTMLDivElement> {
     /** @internal */
     className?: string;
 }
-/**
- * A card surface with consistent border-radius, shadow, and white background.
- * Used for: recent conversation card, help about card, chat input container, etc.
- */
 export declare const Card: import("react").ForwardRefExoticComponent<CardProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/src/components/base/Flex.d.ts

@@ -1,14 +1,5 @@
 import { type ReactNode } from 'react';
 import { type SurfaceProps } from './Surface';
-/**
- * Flex extends Surface with flexbox semantics.
- *
- * Composes `Surface` so that the prop-forwarding, className merging, and
- * elevation/padding/background/radius/layout handling all live in exactly
- * one place. Flex's only contribution is the `flex` utility class plus an
- * optional `flex-col` from the `direction` prop. Public API is unchanged
- * for callers.
- */
 export interface FlexProps extends SurfaceProps {
     direction?: 'row' | 'column';
     children?: ReactNode;

package/dist/src/components/base/icons.d.ts

@@ -153,7 +153,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** Home icon — from MessengerShell TAB_ICONS.home, viewBox 0 0 24 24 */
     readonly home: {
         readonly viewBox: "0 0 24 24";
         readonly paths: [{
@@ -165,7 +164,6 @@ export declare const icons: {
             readonly strokeLinejoin: "round";
         }];
     };
-    /** Chat bubble dots icon — from MessengerShell TAB_ICONS.chat and HomeView CTA */
     readonly chat: {
         readonly viewBox: "0 0 24 24";
         readonly paths: [{
@@ -177,7 +175,6 @@ export declare const icons: {
             readonly strokeLinejoin: "round";
         }];
     };
-    /** Send / arrow right — from MessageInput send button */
     readonly send: {
         readonly viewBox: "0 0 24 24";
         readonly paths: [{
@@ -189,7 +186,6 @@ export declare const icons: {
             readonly strokeLinejoin: "round";
         }];
     };
-    /** Close X (small) — 12×12 viewBox used in NotificationToast, WidgetSettingsLoader */
     readonly closeSmall: {
         readonly viewBox: "0 0 12 12";
         readonly paths: [{
@@ -201,7 +197,6 @@ export declare const icons: {
             readonly strokeLinejoin: "round";
         }];
     };
-    /** Close X (fill) — 20×20 fill variant used in MessengerShell header/minimized state */
     readonly close: {
         readonly viewBox: "0 0 20 20";
         readonly paths: [{
@@ -211,7 +206,6 @@ export declare const icons: {
             readonly clipRule: "evenodd";
         }];
     };
-    /** Chevron down — from WidgetButton open/close toggle */
     readonly chevronDown: {
         readonly viewBox: "0 0 24 24";
         readonly paths: [{
@@ -223,7 +217,6 @@ export declare const icons: {
             readonly strokeLinejoin: "round";
         }];
     };
-    /** Screen share / video camera — from MessengerShell header screen share button */
     readonly screenShare: {
         readonly viewBox: "0 0 24 24";
         readonly paths: [{
@@ -235,7 +228,6 @@ export declare const icons: {
             readonly strokeLinejoin: "round";
         }];
     };
-    /** Alert circle / error — from VideoStreamDisplay stream error state */
     readonly alertCircle: {
         readonly viewBox: "0 0 24 24";
         readonly paths: [{

package/dist/src/components/blocks/HeaderBar.d.ts

@@ -4,7 +4,6 @@ export interface HeaderBarProps {
     subtitle?: string;
     minimized?: boolean;
     onClose: () => void;
-    /** Optional control buttons rendered before the close button */
     controls?: React.ReactNode;
 }
 export declare const HeaderBar: React.FC<HeaderBarProps>;

package/dist/src/components/navigation/ViewTransition.d.ts

@@ -4,11 +4,5 @@ interface ViewTransitionProps {
     children: React.ReactNode;
     direction: ViewDirection;
 }
-/**
- * Wrapper that applies view slide animation.
- * Forward: enter from right (translateX 20px → 0).
- * Back: enter from left (translateX -20px → 0).
- * Animation driven by data-view-transition + data-direction CSS selectors in index.css.
- */
 export declare const ViewTransition: React.FC<ViewTransitionProps>;
 export {};

package/dist/src/components/ui/StateMessage.d.ts

@@ -4,9 +4,5 @@ interface StateMessageProps {
     variant: StateMessageVariant;
     message: string;
 }
-/**
- * Standardized skeleton/loading, empty, and error states using design tokens.
- * Use in message list, composer, or any surface that needs consistent state UI.
- */
 export declare const StateMessage: React.FC<StateMessageProps>;
 export {};

package/dist/src/components/views/ChatView.d.ts

@@ -14,7 +14,6 @@ export interface ChatViewProps {
     onStopTask?: () => void;
     onClearChat?: () => void | Promise<void>;
     onScreenSharingChange?: (isSharing: boolean) => void;
-    /** Refs for header buttons to trigger screen share start/stop */
     onStartScreenShareRef?: React.MutableRefObject<(() => void) | null>;
     onStopScreenShareRef?: React.MutableRefObject<(() => void) | null>;
     /** Optional ref for focus trap to focus the message input */

package/dist/src/context/ChatContext.d.ts

@@ -1,17 +1,6 @@
 import React from 'react';
 import type { ChatMessage, InstructionType } from '../types';
 import type { UIStateActions } from './UIStateContext';
-/**
- * ChatContext — the single store for the widget's conversation.
- *
- * Holds `{ messages, task }` as ONE `SseState`, so the SSE effect commits each
- * transition through a single atomic `setState(prev => transition(prev))`. This
- * removes the previous two-store split (ChatContext + TaskContext), which forced
- * a raw-setState escape hatch and `messagesRef`/`taskRef` snapshots and could
- * tear (messages updating while task lagged across an await). UIStateContext
- * (open/minimized/mode/loading/error) stays separate — a genuinely different
- * concern.
- */
 export interface SimulationState {
     activeSimulationId: string | null;
     isSimulationRunning: boolean;
@@ -43,11 +32,8 @@ interface ChatContextType {
 interface ChatProviderProps {
     children: React.ReactNode;
     previewMode?: boolean;
-    /** Current mode from UIState — fallback for messageDispatch and progress-line logic. */
     currentMode: InstructionType;
-    /** Injected UI actions so the conversation store drives loading/availability/error without nesting contexts. */
     uiActions: Pick<UIStateActions, 'setLoading' | 'setAgentAvailable' | 'setError'>;
-    /** One-time hydrated snapshot to seed the store (messages + task) on mount. */
     initialMessages?: ChatMessage[];
     initialTask?: SimulationState;
 }

package/dist/src/context/UIStateContext.d.ts

@@ -18,7 +18,6 @@ export interface UIStateActions {
     setAgentAvailable: (available: boolean) => void;
     setError: (error: string | undefined) => void;
     clearError: () => void;
-    /** Bulk-apply partial state overrides. */
     applyState: (payload: Partial<UIState>) => void;
 }
 interface UIStateContextType {

package/dist/src/context/WidgetProviders.d.ts

@@ -1,14 +1,3 @@
-/**
- * WidgetProviders — composition root that wires UIStateProvider and
- * ChatProvider together.
- *
- * Conversation state ({ messages, task }) lives in ONE store (ChatProvider);
- * UI state (open/minimized/mode/loading/error) lives in UIStateProvider. Both
- * one-time initialization (SSE connection, ChatService hydration) and persistence
- * live in inner bridge components that can read every context. React context is
- * the single source of truth; ChatService is the load/persist boundary only,
- * driven by one effect here.
- */
 import React from 'react';
 interface WidgetProvidersProps {
     children: React.ReactNode;

package/dist/src/context/sseReducer.d.ts

@@ -1,13 +1,3 @@
-/**
- * Pure SSE reducer — the single place where a `WidgetEvent` turns into the next
- * widget state. No transport, no tool execution, no localStorage: just
- * `(state, event) => { state, effects }`. The ChatContext effect wires
- * this up, runs the returned effects (tool exec, wsClient.send, setLoading), and
- * re-enters via the tool-progress helpers once an async tool finishes.
- *
- * Keeping this pure makes the previously-untestable ~180-line SSE handler unit
- * testable and removes the nested setState-within-setState that hid bugs.
- */
 import type { WidgetEvent } from '../sdk';
 import type { ChatMessage, InstructionType } from '../types';
 export interface SseSimulationState {
@@ -35,15 +25,8 @@ export interface ReduceResult {
     effects: SseEffect[];
 }
 type ProgressStatus = 'in_progress' | 'completed' | 'failed';
-/** Public: progress transition used by the wiring layer for tool lifecycle. */
 export declare function reduceToolProgress(state: SseState, browserToolName: string, explanation: string, status: ProgressStatus, currentMode: InstructionType, error?: string): SseState;
-/** Public: terminal `done` tool — strip the in-flight `done` progress line and end the task. */
 export declare function reduceToolDone(state: SseState, currentMode: InstructionType): SseState;
-/** Public: user-initiated stop — flag the active message `stopped` and end the task. */
 export declare function reduceStop(state: SseState, currentMode: InstructionType): SseState;
-/**
- * Pure reducer. Returns the next state plus any side effects the wiring must run.
- * Unknown / non-stateful events (registered, heartbeat) are ignored.
- */
 export declare function reduceSse(state: SseState, event: WidgetEvent, currentMode: InstructionType): ReduceResult;
 export {};

package/dist/src/design-system/semantic-tokens.d.ts

@@ -34,11 +34,4 @@ export type WidgetStyleSettingsDefaults = Pick<WidgetSettingsData, 'widget_backg
 export declare const WIDGET_STYLE_SETTINGS_DEFAULTS: WidgetStyleSettingsDefaults;
 export declare function mapWidgetSettingsToSemanticTokens(settings: WidgetStyleSettingsDefaults): SemanticTokens;
 export declare const DEFAULT_SEMANTIC_TOKENS: SemanticTokens;
-/**
- * Convert tokens to CSS custom properties.
- * Applied as inline styles on the widget root to override static CSS defaults
- * set by `:host` in index.css. Must cover every variable that Tailwind utilities
- * or base-component classes reference so the widget renders correctly inside
- * closed Shadow DOM regardless of host page styles.
- */
 export declare function semanticTokensToCssCustomProperties(tokens: SemanticTokens): Record<string, string>;

package/dist/src/design-system/shadows.d.ts

@@ -1,15 +1,9 @@
-/** Shared shadow tokens used across all widget components */
 export declare const SHADOW: {
     readonly none: "none";
-    /** Cards, message bubbles, chips — subtle elevation */
     readonly card: "0 1px 4px rgba(0,0,0,0.1)";
-    /** Header bar, tab bar — section separator */
     readonly section: "0 2px 8px rgba(0,0,0,0.06)";
-    /** Main widget panel — strong overlay elevation */
     readonly panel: "0 12px 40px rgba(0,0,0,0.16), 0 4px 12px rgba(0,0,0,0.08)";
-    /** FAB button */
     readonly fab: "0 2px 8px rgba(0,0,0,0.18), 0 0 0 1px rgba(0,0,0,0.04)";
-    /** Scroll-to buttons */
     readonly button: "0 4px 6px -1px rgba(0,0,0,0.1)";
 };
 export type ShadowToken = keyof typeof SHADOW;

package/dist/src/hooks/useFocusTrap.d.ts

@@ -1,8 +1,3 @@
-/**
- * Trap focus inside container when active. On mount when active, focus first focusable
- * (or focusTargetRef if provided). Tab cycles within container. On deactivate, return focus
- * to previously focused element. Escape calls onEscape when provided.
- */
 export declare function useFocusTrap(containerRef: React.RefObject<HTMLElement | null>, isActive: boolean, options?: {
     onEscape?: () => void;
     focusTargetRef?: React.RefObject<HTMLElement | null>;

package/dist/src/hooks/useScrollLock.d.ts

@@ -1,6 +1 @@
-/**
- * Locks body scroll when enabled (e.g. widget open on mobile).
- * Uses matchMedia('(max-width: 767px)') for mobile detection.
- * Restores overflow on disable or unmount.
- */
 export declare function useScrollLock(enabled: boolean): void;

package/dist/src/hooks/useWidget.d.ts

@@ -24,11 +24,6 @@ interface UseWidgetActions {
     clearChatHistory: () => void;
     messageDispatch: (content: string, mode?: InstructionType, applicationId?: number, question?: string, skipUserMessage?: boolean) => Promise<void>;
 }
-/**
- * Composes UIStateContext and ChatContext into the unified
- * `{ state, actions, config, … }` shape that the widget UI consumes. New code
- * can either keep using this hook or read the focused contexts directly.
- */
 export declare const useWidget: ({ config }?: UseWidgetProps) => {
     state: WidgetState;
     actions: UseWidgetActions;

package/dist/src/index.d.ts

@@ -10,28 +10,11 @@ import type { AddWidgetConfig, MarketrixConfig, MarketrixWidgetProps } from './t
 import { getCurrentConfig } from './utils/bootstrap';
 export declare const initWidget: (config: MarketrixConfig, container?: HTMLElement) => Promise<void>;
 export declare const unmountWidget: () => void;
-/**
- * Stop RRWeb session recording without unmounting the widget.
- * Keeps the RrwebSessionRecorder instance so recording can be restarted with startRecording().
- * RrwebSessionRecorder.stop() aborts in-flight start() via stopRequested.
- */
 export declare const stopRecording: () => void;
-/**
- * Start RRWeb session recording. Use after stopRecording() to resume, or when recording was not started on init.
- * Safe to call while auto-start is in-flight — awaits the pending start instead of creating a concurrent one.
- * @throws Error if session recorder was never created (e.g. missing mtxApiHost/mtxApp).
- */
 export declare const startRecording: () => Promise<void>;
-/**
- * Returns whether RRWeb session recording is currently active.
- */
 export declare const getRecordingState: () => boolean;
 export declare const updateMarketrixConfig: (newConfig: Partial<MarketrixConfig>) => Promise<void>;
 export { getCurrentConfig };
-/**
- * MarketrixWidget - React component for preview mode
- * Renders widget into parent container with shadow DOM
- */
 export declare const MarketrixWidget: React.FC<MarketrixWidgetProps>;
 export declare const mountWidget: (config: AddWidgetConfig) => Promise<void>;
 export type { InstructionType } from './sdk';

package/dist/src/sdk/contracts/common.d.ts

@@ -5,9 +5,6 @@ export declare const EntityStatusSchema: z.ZodEnum<{
     suspended: "suspended";
     pending_approval: "pending_approval";
 }>;
-/**
- * Base entity schema with common fields for all database entities
- */
 export declare const BaseEntitySchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodNumber>;
     created_at: z.ZodOptional<z.ZodCoercedDate<unknown>>;

package/dist/src/sdk/contracts/entities.d.ts

@@ -49,10 +49,6 @@ export declare const InstructionTypeSchema: z.ZodEnum<{
     do: "do";
 }>;
 export type InstructionType = z.infer<typeof InstructionTypeSchema>;
-/**
- * Complete user entity schema
- * Note: Users don't have plans - plans belong to workspaces (via workspace_plan table)
- */
 export declare const UserEntitySchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodNumber>;
     created_at: z.ZodOptional<z.ZodCoercedDate<unknown>>;
@@ -77,11 +73,6 @@ export declare const UserEntitySchema: z.ZodObject<{
     }>>>;
 }, z.core.$strip>;
 export type UserData = z.infer<typeof UserEntitySchema>;
-/**
- * Complete workspace entity schema
- * Note: package and ending_date come from workspace_plan table (joined when fetching workspace data).
- * They are NOT stored on the workspace table itself.
- */
 export declare const WorkspaceEntitySchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodNumber>;
     created_at: z.ZodOptional<z.ZodCoercedDate<unknown>>;
@@ -163,6 +154,7 @@ export declare const SimPersonaReactionEntitySchema: z.ZodObject<{
     user_index: z.ZodNullable<z.ZodNumber>;
     simulation_id: z.ZodNullable<z.ZodNumber>;
     study_variant_id: z.ZodNullable<z.ZodNumber>;
+    study_task_id: z.ZodNullable<z.ZodNumber>;
     journey_reaction: z.ZodNullable<z.ZodString>;
     journey_sentiment: z.ZodNullable<z.ZodEnum<{
         positive: "positive";
@@ -226,6 +218,7 @@ export declare const SimulationEntitySchema: z.ZodObject<{
     step_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     started_at: z.ZodOptional<z.ZodNullable<z.ZodCoercedDate<unknown>>>;
     completed_at: z.ZodOptional<z.ZodNullable<z.ZodCoercedDate<unknown>>>;
+    output_persisted_at: z.ZodOptional<z.ZodNullable<z.ZodCoercedDate<unknown>>>;
     graph_status: z.ZodOptional<z.ZodEnum<{
         completed: "completed";
         failed: "failed";
@@ -248,6 +241,7 @@ export declare const SimulationEntitySchema: z.ZodObject<{
         user_index: z.ZodNullable<z.ZodNumber>;
         simulation_id: z.ZodNullable<z.ZodNumber>;
         study_variant_id: z.ZodNullable<z.ZodNumber>;
+        study_task_id: z.ZodNullable<z.ZodNumber>;
         journey_reaction: z.ZodNullable<z.ZodString>;
         journey_sentiment: z.ZodNullable<z.ZodEnum<{
             positive: "positive";

package/dist/src/sdk/contracts/widget.d.ts

@@ -1,8 +1,5 @@
 import { z } from 'zod';
 import { WidgetSettingsDataSchema } from './entities';
-/**
- * Application with widgets schema — matches API response structure
- */
 export declare const ApplicationWithWidgetsSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodNumber>;
     created_at: z.ZodOptional<z.ZodCoercedDate<unknown>>;
@@ -217,7 +214,7 @@ export declare const WidgetUpdateSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type WidgetUpdateData = z.infer<typeof WidgetUpdateSchema>;
 export type WidgetSettingsKey = keyof z.infer<typeof WidgetSettingsDataSchema>;
-/** Server → Widget event (discriminated union on `type`) */
+/** Server → Widget events. */
 export declare const WidgetEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"registered">;
     chat_id: z.ZodString;
@@ -261,7 +258,7 @@ export declare const WidgetEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     state_version: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>], "type">;
 export type WidgetEvent = z.infer<typeof WidgetEventSchema>;
-/** Widget → Server command (discriminated union on `type`) */
+/** Widget → Server commands. */
 export declare const WidgetCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"chat/tell">;
     request_id: z.ZodString;

package/dist/src/services/ApiService.d.ts

@@ -3,18 +3,10 @@ export declare class ApiService {
     private config;
     constructor(config: MarketrixConfig);
     getChatId(): string | null;
-    /**
-     * Get user_id from various sources (config, localStorage, sessionStorage)
-     */
+    /** Resolves user_id from config, then localStorage, then sessionStorage. */
     private getUserId;
     logWidgetQuestion(question: string, mode: string): Promise<void>;
-    /**
-     * Send a message via the typed stream (fire-and-forget).
-     * The actual response arrives asynchronously as a chat/response stream event.
-     */
+    /** Fire-and-forget send over the typed stream; the reply arrives asynchronously as a chat/response event. */
     messageDispatch(request: MessageDispatchRequest): Promise<MessageDispatchResponse>;
-    /**
-     * Update configuration
-     */
     updateConfig(newConfig: Partial<MarketrixConfig>): void;
 }

package/dist/src/services/BrowserToolService.d.ts

@@ -96,11 +96,7 @@ export declare class BrowserToolService {
     private selectDropdownOption;
     private getDropdownOptions;
     private sendKeys;
-    /**
-     * Simulate actual browser behavior for special keys
-     * Since programmatic KeyboardEvents are not "trusted", we need to
-     * manually trigger the expected behavior
-     */
+    /** Programmatic KeyboardEvents aren't "trusted", so manually reproduce each key's expected behavior. */
     private simulateKeyAction;
     private uploadFile;
     private closeTab;

package/dist/src/services/ChatService.d.ts

@@ -1,9 +1,5 @@
 import type { ChatMessage, InstructionType } from '../types';
-/**
- * Snapshot of widget state persisted to / restored from localStorage.
- * React context is the single source of truth at runtime — this is the
- * load/persist boundary only.
- */
+/** Widget state persisted to / restored from localStorage; React context is the runtime source of truth. */
 export interface ChatSnapshot {
     messages: ChatMessage[];
     isSimulationRunning: boolean;
@@ -13,12 +9,7 @@ export interface ChatSnapshot {
     isMinimized: boolean;
     isLoading: boolean;
 }
-/**
- * ChatService — thin persistence layer.
- *
- * Owns only the localStorage read/write lifecycle for the widget chat context:
- * contexts call `persist(snapshot)` from a single effect and `restore()` once on mount.
- */
+/** localStorage read/write lifecycle for the widget chat context: `persist(snapshot)` from an effect, `restore()` once on mount. */
 export declare class ChatService {
     private static instance;
     private chatId;
@@ -28,9 +19,8 @@ export declare class ChatService {
     initialize(chatId: string | null): void;
     createInitialContext(chatId: string): void;
     getInitError(): Error | null;
-    /** Read the persisted snapshot, rehydrating messages (dates, lost streams). */
     restore(): ChatSnapshot;
-    /** Persist the current widget snapshot. No-op until a chatId is known. */
+    /** No-op until a chatId is known. */
     persist(snapshot: ChatSnapshot): void;
 }
 export declare const chatService: ChatService;

package/dist/src/services/ChatSessionManager.d.ts

@@ -1,9 +1,3 @@
-/**
- * Chat ID Manager Service
- *
- * Centralized chat ID management with promise-based locking to prevent
- * concurrent chat ID creation. Ensures only one chat ID is created per session.
- */
 declare class ChatSessionManager {
     private static instance;
     private chatId;
@@ -11,14 +5,8 @@ declare class ChatSessionManager {
     private constructor();
     static getInstance(): ChatSessionManager;
     getChatId(): string | null;
-    /**
-     * Get or create chat ID with promise-based locking
-     * If multiple calls happen concurrently, they all wait for the same promise
-     */
+    /** Promise-based lock: concurrent callers all await the same creation promise. */
     getOrCreateChatId(): Promise<string>;
-    /**
-     * Create a new chat ID - oRPC returns data directly
-     */
     private createChatId;
     private getStoredChatId;
     private storeChatId;

package/dist/src/services/ConfigManager.d.ts

@@ -12,9 +12,5 @@ export declare class ConfigManager {
     shouldShowWidget(): boolean;
 }
 export declare const configManager: ConfigManager;
-/**
- * Creates MarketrixConfig from WidgetSettingsData
- * Since MarketrixConfig extends WidgetSettingsData, this is just a direct merge.
- * API settings (which include defaults) override base config.
- */
+/** API settings (defaults included) override the base config. */
 export declare function createConfigFromSettings(widgetSettings: WidgetSettingsData, baseConfig?: Partial<MarketrixConfig>): MarketrixConfig;

package/dist/src/services/DomService.d.ts

@@ -33,28 +33,16 @@ export declare class DomService {
     static getInstance(): DomService;
     private generateSelector;
     private generateFingerprint;
-    /**
-     * Check if an element matches a stored fingerprint.
-     * Uses strict matching - fails if any key attribute differs.
-     */
+    /** Strict match against a stored fingerprint — fails if any key attribute differs. */
     private matchesFingerprint;
-    /**
-     * Validate that the element at a given index still matches its fingerprint.
-     * No recovery - just check if element exists and matches.
-     */
+    /** Check the element at an index still matches its fingerprint; no recovery. */
     private validateElementAtIndex;
-    /**
-     * Index all interactable elements in the live DOM.
-     * Always clears previous index first.
-     */
+    /** Index all interactable elements in the live DOM, clearing any previous index first. */
     indexInteractableElements(): Array<[number, Element]>;
     private getElementCoordinates;
     private isStackingContext;
     private calculateGlobalZOrder;
-    /**
-     * Get HTML snapshot with data-id attributes injected.
-     * This re-indexes the live DOM and then produces a corresponding HTML string.
-     */
+    /** Re-index the live DOM and return an HTML snapshot with data-id attributes injected. */
     getSnapshotHtml(): string;
     getInteractableElements(): Array<{
         index: number;
@@ -70,26 +58,13 @@ export declare class DomService {
     }>;
     getSequenceForElement(element: Element): number | undefined;
     clearIndex(): void;
-    /**
-     * Check if an element is interactable (visible, not hidden, not obscured).
-     * Returns error string if not interactable, null if OK.
-     */
+    /** Returns an error string if the element isn't interactable (hidden/obscured/off-screen), null if OK. */
     private checkInteractability;
-    /**
-     * Public method to check element interactability (for use by ShowModeService).
-     */
+    /** Public interactability check for ShowModeService. */
     checkElementInteractable(element: HTMLElement, index: number): string | null;
-    /**
-     * Get an interactive element by its index.
-     * Returns element only if it's interactable, otherwise returns null with error.
-     */
+    /** Look up an element by index; returns it only if interactable, else null + error. */
     getElementByIndex(index: number): ElementLookupResult;
-    /**
-     * Get an element by index with validation.
-     * This is the main entry point for BrowserToolService to use.
-     * It validates the element matches its fingerprint and attempts recovery if not.
-     * Returns element only if it's interactable.
-     */
+    /** Main entry point for BrowserToolService: validate against fingerprint, then return if interactable. */
     getValidatedElement(index: number): ValidatedElementResult;
 }
 export declare const domService: DomService;

package/dist/src/services/RrwebSessionRecorder.d.ts

@@ -1,7 +1,4 @@
-/**
- * RrwebSessionRecorder manages real-time RRWeb session recording,
- * sending batched events to the API via HTTP POST (widget message endpoint).
- */
+/** Real-time RRWeb recording; batched events POSTed to the API widget-message endpoint. */
 export declare class RrwebSessionRecorder {
     private eventQueue;
     private estimatedQueueBytes;
@@ -20,23 +17,13 @@ export declare class RrwebSessionRecorder {
     private metadataEmit;
     private bufferEvent;
     /**
-     * Flush buffered events via POST.
-     *
-     * Batches are capped at MAX_BATCH_BYTES to stay within the API body-parser limit.
-     * On transient server errors (5xx / network) the batch is re-queued up to
-     * MAX_CONSECUTIVE_FAILURES times before being dropped.
-     * On permanent client errors (4xx) the batch is dropped immediately — re-sending
-     * would never succeed and would create an infinite retry loop.
+     * POST buffered events (batch capped at MAX_BATCH_BYTES). Transient errors (5xx/network) re-queue
+     * up to MAX_CONSECUTIVE_FAILURES; permanent errors (4xx) drop immediately (a retry never succeeds).
      */
     private flush;
-    /**
-     * Start recording session.
-     * Safe against concurrent calls (returns existing startPromise).
-     */
+    /** Concurrent-call safe — returns the in-flight startPromise. */
     start(): Promise<void>;
-    /**
-     * Internal start implementation. Checks stopRequested at each async boundary.
-     */
+    /** Rechecks stopRequested at each async boundary so a mid-startup stop aborts cleanly. */
     private doStart;
     stop(): void;
     getSessionId(): string;

package/dist/src/services/ScreenShareService.d.ts

@@ -1,12 +1,4 @@
-/**
- * Screen Share Service
- * Manages screensharing state and provides shared access to the active MediaStream
- * for use across the widget (chatWindow, toolExecutor, etc.)
- */
-/**
- * Start screen sharing. If already active, returns the existing stream.
- * @returns Promise resolving to the MediaStream
- */
+/** Reuses the existing stream if one is still active. */
 export declare function startScreenShare(): Promise<MediaStream>;
 export declare function stopScreenShare(): void;
 export declare function isScreenSharing(): boolean;