@marketrix.ai/widget 3.8.40 → 3.8.117

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

@@ -1,6 +1,3 @@
-/**
- * Fingerprint of an indexed element for validation
- */
 export interface ElementFingerprint {
     tagName: string;
     id: string | null;
@@ -13,23 +10,14 @@ export interface ElementFingerprint {
     selector: string;
     indexVersion: number;
 }
-/**
- * Result of validating an element at a given index
- */
 export interface ValidationResult {
     isValid: boolean;
     mismatchReason?: 'element_removed' | 'element_changed';
 }
-/**
- * Result of looking up an element by index
- */
 export interface ElementLookupResult {
     element: HTMLElement | null;
     error?: string;
 }
-/**
- * Result of validated element lookup (includes validation info)
- */
 export interface ValidatedElementResult extends ElementLookupResult {
     validation: ValidationResult;
 }
@@ -39,18 +27,11 @@ export declare class DomService {
     private elementToSequence;
     private selectorMap;
     private fingerprintMap;
-    private isIndexed;
     private indexingInProgress;
     private indexVersion;
     private constructor();
     static getInstance(): DomService;
-    /**
-     * Generate a unique CSS selector for an element
-     */
     private generateSelector;
-    /**
-     * Generate a fingerprint for an element to enable validation later
-     */
     private generateFingerprint;
     /**
      * Check if an element matches a stored fingerprint.
@@ -62,48 +43,19 @@ export declare class DomService {
      * No recovery - just check if element exists and matches.
      */
     private validateElementAtIndex;
-    /**
-     * Export state for external persistence (selectors and fingerprints)
-     */
-    exportState(): {
-        selectors: Array<[number, string]>;
-        fingerprints: Array<[number, ElementFingerprint]>;
-    };
-    /**
-     * Import state from external persistence (selectors and fingerprints)
-     */
-    importState(state: {
-        selectors?: Array<[number, string]>;
-        fingerprints?: Array<[number, ElementFingerprint]>;
-    }): void;
     /**
      * Index all interactable elements in the live DOM.
      * Always clears previous index first.
      */
     indexInteractableElements(): Array<[number, Element]>;
-    /**
-     * Get element coordinates using getBoundingClientRect()
-     * Returns viewport-relative coordinates
-     */
     private getElementCoordinates;
-    /**
-     * Check if an element creates a stacking context
-     * Based on CSS stacking context rules
-     */
     private isStackingContext;
-    /**
-     * Calculate global z-order for an element
-     * Traverses up the DOM tree to identify stacking contexts and calculate z-order
-     */
     private calculateGlobalZOrder;
     /**
      * Get HTML snapshot with data-id attributes injected.
      * This re-indexes the live DOM and then produces a corresponding HTML string.
      */
     getSnapshotHtml(): string;
-    /**
-     * Get actionable elements metadata
-     */
     getInteractableElements(): Array<{
         index: number;
         fingerprint: ElementFingerprint;
@@ -116,9 +68,7 @@ export declare class DomService {
         };
         cssClasses: string[];
     }>;
-    getElementByDataId(id: number): Element | undefined;
     getSequenceForElement(element: Element): number | undefined;
-    isIndexActive(): boolean;
     clearIndex(): void;
     /**
      * Check if an element is interactable (visible, not hidden, not obscured).
@@ -141,17 +91,5 @@ export declare class DomService {
      * Returns element only if it's interactable.
      */
     getValidatedElement(index: number): ValidatedElementResult;
-    /**
-     * Get fingerprint for a given index (for debugging/testing)
-     */
-    getFingerprint(index: number): ElementFingerprint | undefined;
-    /**
-     * Get all fingerprints (for debugging/testing)
-     */
-    getAllFingerprints(): Array<[number, ElementFingerprint]>;
-    /**
-     * Get current index version
-     */
-    getIndexVersion(): number;
 }
 export declare const domService: DomService;

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

@@ -8,12 +8,5 @@
  * @returns Promise resolving to the MediaStream
  */
 export declare function startScreenShare(): Promise<MediaStream>;
-/**
- * Stop screen sharing and clear the stream reference.
- */
 export declare function stopScreenShare(): void;
-/**
- * Check if screensharing is currently active.
- * @returns True if screensharing is active, false otherwise
- */
 export declare function isScreenSharing(): boolean;

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

@@ -9,13 +9,7 @@ declare class SessionManager {
     private chatId;
     private initializationPromise;
     private constructor();
-    /**
-     * Get singleton instance
-     */
     static getInstance(): SessionManager;
-    /**
-     * Get current chat ID without creating a new one
-     */
     getChatId(): string | null;
     /**
      * Get or create chat ID with promise-based locking

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

@@ -17,13 +17,7 @@ export declare class SessionRecorder {
     private consecutiveFailures;
     private isFlushing;
     constructor(chatId: string, applicationId: number);
-    /**
-     * Send rrweb/metadata command via POST
-     */
     private sendMetadata;
-    /**
-     * Buffer an event and trigger flush if thresholds are met
-     */
     private bufferEvent;
     /**
      * Flush buffered events via POST.
@@ -44,16 +38,7 @@ export declare class SessionRecorder {
      * Internal start implementation. Checks stopRequested at each async boundary.
      */
     private doStart;
-    /**
-     * Stop recording session. Flushes remaining events before stopping.
-     */
     stop(): void;
-    /**
-     * Get current session ID
-     */
     getSessionId(): string;
-    /**
-     * Check if recording is active
-     */
     isActive(): boolean;
 }

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

@@ -15,22 +15,18 @@
  * widget owns the read/write lifecycle, and the dashboard only ever reads
  * the same shape for parity.
  */
-import type { ChatMessage, InstructionType, MarketrixConfig, TaskProgress } from '../types';
+import type { ChatMessage, InstructionType, MarketrixConfig } from '../types';
 /**
  * Serializable version of ChatMessage (timestamp as string, no videoStream)
  */
 type StoredMessage = Omit<ChatMessage, 'videoStream' | 'timestamp'> & {
     timestamp: string;
 };
-/**
- * Unified storage structure for all widget data
- */
 export interface MarketrixChatContext {
     chat_id: string | null;
     messages: StoredMessage[];
     isTaskRunning: boolean;
     activeTaskId: string | null;
-    taskProgress: TaskProgress[];
     currentMode: InstructionType;
     isOpen: boolean;
     isMinimized: boolean;
@@ -49,25 +45,10 @@ declare class StorageService {
     private context;
     private constructor();
     static getInstance(): StorageService;
-    /**
-     * Load context from localStorage
-     */
     private loadContext;
-    /**
-     * Save context to localStorage
-     */
     private saveContext;
-    /**
-     * Get the full context
-     */
     getContext(): MarketrixChatContext;
-    /**
-     * Update context with partial data
-     */
     updateContext(updates: Partial<MarketrixChatContext>): void;
-    /**
-     * Check if a string is a valid chat_id
-     */
     private isValidChatId;
     /**
      * Get chat_id with window.name fallback for cross-page navigation
@@ -81,14 +62,11 @@ declare class StorageService {
     setChatId(chatId: string | null): void;
     getMessages(): StoredMessage[];
     setMessages(messages: StoredMessage[]): void;
-    getChatState(): Pick<MarketrixChatContext, 'isTaskRunning' | 'activeTaskId' | 'taskProgress' | 'currentMode' | 'isOpen' | 'isMinimized' | 'isLoading'>;
-    setChatState(state: Partial<Pick<MarketrixChatContext, 'isTaskRunning' | 'activeTaskId' | 'taskProgress' | 'currentMode' | 'isOpen' | 'isMinimized' | 'isLoading'>>): void;
+    getChatState(): Pick<MarketrixChatContext, 'isTaskRunning' | 'activeTaskId' | 'currentMode' | 'isOpen' | 'isMinimized' | 'isLoading'>;
+    setChatState(state: Partial<Pick<MarketrixChatContext, 'isTaskRunning' | 'activeTaskId' | 'currentMode' | 'isOpen' | 'isMinimized' | 'isLoading'>>): void;
     getConfig(): MarketrixConfig | null;
     setConfig(config: MarketrixConfig | null): void;
     clear(): void;
-    /**
-     * Check if context exists and has a valid chat_id
-     */
     hasValidContext(): boolean;
 }
 export declare const storageService: StorageService;

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

@@ -20,13 +20,6 @@ export declare class ValidationService {
      * Handles both mtxId+mtxKey and mtxApp cases
      */
     validateConfig(config: MarketrixConfig): Promise<WidgetValidationResult>;
-    /**
-     * Validate by mtxId and mtxKey
-     */
     private validateByMarketrixId;
-    /**
-     * Validate by mtxApp directly
-     * Validates the application by ID
-     */
     private validateByApplication;
 }

package/dist/src/types/browserTools.d.ts

@@ -2,8 +2,8 @@
  * Browser Use Tools - widget tool registry.
  *
  * IMPORTANT: This file is the single source of truth for widget tool metadata.
- * ALLOWED_TOOLS in TaskContext.tsx and TOOL_NAME_MAPPING in chat.ts are derived
- * from BROWSER_TOOLS below.
+ * ALLOWED_TOOLS in ConversationContext.tsx and TOOL_NAME_MAPPING in chat.ts are
+ * derived from BROWSER_TOOLS below.
  */
 interface BrowserToolMetadata {
     id: string;

package/dist/src/types/index.d.ts

@@ -56,14 +56,6 @@ export interface MessagePart {
     hideIcon?: boolean;
     textStyle?: 'default' | 'muted';
 }
-export interface TaskProgress {
-    tool_name: string;
-    tool_params: Record<string, unknown>;
-    step: number;
-    explanation: string;
-    mode: string;
-    timestamp: number;
-}
 export type WidgetView = 'home' | 'chat';
 export interface WidgetState {
     isOpen: boolean;
@@ -75,7 +67,6 @@ export interface WidgetState {
     error?: string;
     activeTaskId: string | null;
     isTaskRunning: boolean;
-    taskProgress: TaskProgress[];
     activeView: WidgetView;
 }
 export interface SendMessageRequest {
@@ -95,10 +86,6 @@ export interface SendMessageResponse {
     task_id?: string;
 }
 export type WidgetPosition = WidgetSettingsData['widget_position'];
-/**
- * Configuration for addWidget function
- * Supports preview, production, and dev modes
- */
 export type AddWidgetConfig = ({
     settings: WidgetSettingsData;
     mtxId?: never;
@@ -128,9 +115,6 @@ export type AddWidgetConfig = ({
     /** Controls screen sharing prompts and button. When false, screen access requests are auto-denied and Share Screen button is hidden. Default: true */
     use_screenshare?: boolean;
 };
-/**
- * Props for MarketrixWidget React component
- */
 export interface MarketrixWidgetProps {
     settings: WidgetSettingsData;
     container?: HTMLElement;

package/dist/src/utils/apiUtils.d.ts

@@ -5,9 +5,6 @@ import type { MarketrixConfig } from '../types';
  * Consolidates error instanceof Error ? error.message : String(error)
  */
 export declare function extractErrorMessage(error: unknown, fallback?: string): string;
-/**
- * Handle API error with consistent error message extraction
- */
 export declare function handleApiError(error: unknown, context?: string, config?: Partial<MarketrixConfig>): {
     isValid: false;
     error: string;

package/dist/src/utils/bootstrap.d.ts

@@ -25,60 +25,16 @@ export declare const createWidgetContainer: (parentContainer?: HTMLElement, cont
  * @param previewMode - If true, disables network operations (for integration previews)
  */
 export declare const mountWidgetToContainer: (mountEl: HTMLElement, config: MarketrixConfig, previewMode?: boolean) => Root;
-/**
- * Destroy widget container
- * @param container - Container to destroy
- */
 export declare const destroyWidgetContainer: (container: HTMLElement) => void;
-/**
- * Get current widget instance
- */
 export declare const getWidgetInstance: () => Root | null;
-/**
- * Set widget instance
- */
 export declare const setWidgetInstance: (instance: Root | null) => void;
-/**
- * Get current configuration
- */
 export declare const getCurrentConfig: () => MarketrixConfig | null;
-/**
- * Set current configuration
- */
 export declare const setCurrentConfig: (config: MarketrixConfig | null) => void;
-/**
- * Check if widget is initialized
- */
 export declare const isWidgetInitialized: () => boolean;
-/**
- * Clear widget instance and config
- */
 export declare const clearWidgetState: () => void;
-/**
- * Set programmatic initialization in progress flag
- */
 export declare const setProgrammaticInitInProgress: (inProgress: boolean) => void;
-/**
- * Check if programmatic initialization is in progress
- */
 export declare const isProgrammaticInitInProgress: () => boolean;
-/**
- * Check if a production widget is already active on this page
- * Production widgets (non-preview) should be singletons - only one per page
- */
-export declare const isProductionWidgetActive: () => boolean;
-/**
- * Set production widget active state
- * Call with true when initializing a production widget, false when unmounting
- */
-export declare const setProductionWidgetActive: (active: boolean) => void;
-/**
- * Show widget settings loader with optional message
- */
 export declare const showWidgetSettingsLoader: (message?: string) => void;
-/**
- * Hide widget settings loader
- */
 export declare const hideWidgetSettingsLoader: () => void;
 /**
  * Auto-initialize widget from script tag attributes

package/dist/src/utils/chat.d.ts

@@ -5,21 +5,9 @@
  * - Removing thinking markers
  */
 import type { ChatMessage, InstructionType } from '../types';
-/**
- * Remove all __THINKING__ markers from message content
- */
 export declare function removeThinkingMarkers(content: string): string;
-/**
- * Remove thinking marker from end of content (for display)
- */
 export declare function removeThinkingMarkerFromEnd(content: string): string;
-/**
- * Check if content has thinking marker
- */
 export declare function hasThinkingMarker(content: string): boolean;
-/**
- * Add thinking marker to content
- */
 export declare function addThinkingMarker(content: string): string;
 /**
  * Message Finder Utility
@@ -56,21 +44,9 @@ export declare function findMessageForProgress(options: FindMessageOptions): {
  * Also the set that requires element highlighting in ToolService.
  */
 export declare const WAIT_FOR_USER_TOOLS: Set<string>;
-/**
- * Add a new progress step to a message
- */
 export declare function addProgressLine(message: ChatMessage, toolName: string, explanation: string): ChatMessage;
-/**
- * Mark the last incomplete progress step as completed
- */
 export declare function markProgressLineComplete(message: ChatMessage, toolName?: string): ChatMessage;
-/**
- * Mark the last incomplete progress step as failed
- */
 export declare function markProgressLineFailed(message: ChatMessage, toolName: string, error: string): ChatMessage;
-/**
- * Add or remove thinking marker based on task state
- */
 export declare function updateThinkingMarker(message: ChatMessage, isTaskRunning: boolean, currentMode: 'show' | 'tell' | 'do', isWaitingForUser?: boolean): ChatMessage;
 /**
  * Tool Name Mapping — derived from BROWSER_TOOLS (single source of truth).

package/dist/src/utils/{format.d.ts → color.d.ts}

@@ -1,26 +1,17 @@
 /**
  * Color utility functions for widget theming
  */
-/**
- * Converts hex color to RGB
- */
 export declare function hexToRgb(hex: string): {
     r: number;
     g: number;
     b: number;
 } | null;
-/**
- * Gets a contrasting color (white or black) based on the background color
- */
 export declare function getContrastingColor(color: string): string;
 /**
  * Adds opacity to a color
  * Supports hex colors (with or without #) and rgb/rgba strings
  */
 export declare function addOpacity(color: string, opacity: number): string;
-/**
- * Darkens a color by a specified amount (0-1)
- */
 export declare function darkenColor(color: string, amount: number): string;
 export declare const formatMessageTime: (date: Date | undefined) => string;
 export declare const getModeDisplayName: (mode: "show" | "tell" | "do") => string;

package/dist/src/utils/dom.d.ts

@@ -4,11 +4,4 @@
  * Centralized utilities for common DOM operations to reduce code duplication
  * and ensure consistent error handling.
  */
-/**
- * Get an interactive element by its index.
- * First tries to use data-id from get_html indexing, then falls back to current behavior.
- * @param index The zero-based index of the element
- * @returns The element at the given index, or null if not found
- */
-export declare function getElementByIndex(index: number): HTMLElement | null;
 export declare function isInteractable(el: Element | null): boolean;

package/dist/src/utils/{common.d.ts → logger.d.ts}

@@ -4,9 +4,6 @@
  * Centralized logging utility with log levels and environment-based filtering.
  * Only logs in development mode to reduce noise in production.
  */
-/**
- * Create a scoped logger with a fixed prefix
- */
 export declare function createLogger(prefix: string): {
     debug: (message: string, ...args: unknown[]) => void;
     info: (message: string, ...args: unknown[]) => void;

package/dist/src/utils/validation.d.ts

@@ -5,19 +5,6 @@
  * These are shared utilities used across the codebase.
  */
 import type { WidgetSettingsData } from '../sdk';
-/**
- * Check if an object has a specific property
- */
-export declare function hasProperty<K extends string>(obj: unknown, key: K): obj is Record<K, unknown>;
-/**
- * Type guard for WidgetSettingsData
- */
 export declare function isWidgetSettingsData(data: unknown): data is WidgetSettingsData;
-/**
- * Type guard for HTMLElement
- */
 export declare function isHTMLElement(element: Element | null): element is HTMLElement;
-/**
- * Type guard for HTMLScriptElement
- */
 export declare function isHTMLScriptElement(element: Element | null): element is HTMLScriptElement;