@marketrix.ai/widget 1.0.0

package/dist/utils/bootstrap.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Widget Initialization, Lifecycle, and Loader Utilities
+ *
+ * Handles widget container creation, shadow DOM setup, mounting, lifecycle management,
+ * and loader display. Consolidates all widget-related DOM manipulation and state management.
+ */
+import { type Root } from 'react-dom/client';
+import type { MarketrixConfig } from '../types';
+/**
+ * Create widget container and shadow DOM
+ * Returns the container element and shadow root
+ * @param parentContainer - Optional parent container to mount within. If provided, shadow DOM will be created within this container.
+ * @param containerId - Optional unique container ID. If not provided, a unique ID will be generated.
+ */
+export declare const createWidgetContainer: (parentContainer?: HTMLElement, containerId?: string) => {
+    container: HTMLElement;
+    shadowRoot: ShadowRoot;
+    mountEl: HTMLElement;
+};
+/**
+ * Mount widget component to the provided mount element
+ * Returns the React root instance
+ */
+export declare const mountWidgetToContainer: (mountEl: HTMLElement, config: MarketrixConfig) => Root;
+/**
+ * Destroy widget container
+ * @param container - Optional specific container to destroy. If not provided, searches for default container.
+ */
+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;
+/**
+ * Show widget settings loader with optional message
+ */
+export declare const showWidgetSettingsLoader: (message?: string) => void;
+/**
+ * Hide widget settings loader
+ */
+export declare const hideWidgetSettingsLoader: () => void;
+/**
+ * Register the widget initialization function and set up auto-initialization
+ *
+ * This function:
+ * 1. Stores the init function synchronously (no delays)
+ * 2. Checks DOM ready state
+ * 3. Either initializes immediately or waits for DOMContentLoaded
+ * 4. Sets up persistence for bookmarklet usage
+ *
+ * @param initWidget - Function to initialize the widget (passed to avoid circular dependency)
+ */
+export declare const registerAutoInit: (initWidget: (config: MarketrixConfig) => Promise<void>) => void;
+//# sourceMappingURL=bootstrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/utils/bootstrap.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAMzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAwBhD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,kBAAkB,WAAW,EAC7B,cAAc,MAAM,KACnB;IACD,SAAS,EAAE,WAAW,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;CAyEtB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,WAAW,EAAE,QAAQ,eAAe,KAAG,IAatF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,YAAY,WAAW,KAAG,IAKhE,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,IAAI,GAAG,IAE3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,IAAI,GAAG,IAAI,KAAG,IAEzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAO,eAAe,GAAG,IAErD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,eAAe,GAAG,IAAI,KAAG,IAEjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAO,OAEtC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAO,IAGnC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,UAAU,MAAM,KAAG,IAsC3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAAO,IAU3C,CAAC;AA2FF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,GAAI,YAAY,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,KAAG,IA+BzF,CAAC"}

package/dist/utils/chat.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Message Content Utilities
+ *
+ * Centralized utilities for message content transformation, including:
+ * - 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;
+/**
+ * Find the index of the last task message (agent message that's not system/placeholder/screen access)
+ */
+export declare function findTaskMessageIndex(messages: ChatMessage[]): number;
+/**
+ * Message Finder Utility
+ *
+ * Centralized logic for finding messages in the chat that should receive
+ * progress updates, tool call results, or errors. Eliminates duplicate
+ * message finding code across websocket handlers.
+ */
+export interface FindMessageOptions {
+    messages: ChatMessage[];
+    isTaskRunning: boolean;
+    currentMode: InstructionType;
+    preferPlaceholder?: boolean;
+    requireContent?: boolean;
+}
+/**
+ * Find the message that should receive progress updates
+ * ALWAYS returns the LAST (most recent) matching message by searching backwards.
+ * Priority order for active show/do tasks:
+ * 1. Placeholder message in show/do mode that has content (the "Let me try this" message)
+ * 2. Placeholder message in show/do mode (even without content yet)
+ * 3. Non-placeholder agent message in show/do mode
+ * For other cases:
+ * 4. Last placeholder message
+ * 5. Last task message
+ * 6. Any agent message as fallback
+ */
+export declare function findMessageForProgress(options: FindMessageOptions): {
+    index: number;
+    message: ChatMessage;
+} | null;
+/**
+ * Find a placeholder message, optionally matching the current mode
+ */
+export declare function findPlaceholderMessage(messages: ChatMessage[], currentMode?: InstructionType): {
+    index: number;
+    message: ChatMessage;
+} | null;
+/**
+ * Add a new progress step to a message
+ */
+export declare function addProgressLine(message: ChatMessage, toolName: string, explanation: string): ChatMessage;
+/**
+ * Update an existing progress step for a tool
+ */
+export declare function updateProgressLine(message: ChatMessage, toolName: string, status: 'pending' | 'completed' | 'failed', error?: 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 Utility
+ *
+ * Provides friendly display names for technical tool names.
+ * Used for showing user-friendly progress updates in the chat.
+ */
+export declare const TOOL_NAME_MAPPING: Record<string, string>;
+/**
+ * Get a friendly display name for a tool
+ * Converts snake_case to Title Case if no mapping exists
+ */
+export declare function getFriendlyToolName(toolName: string): string;
+//# sourceMappingURL=chat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/utils/chat.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE7D;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAapE;AACD;;;;;;GAMG;AAMH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,eAAe,CAAC;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAkDD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;CACtB,GAAG,IAAI,CAsQP;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,WAAW,EAAE,EACvB,WAAW,CAAC,EAAE,eAAe,GAC5B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,CA+BhD;AAsDD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,WAAW,CAuCb;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,EAC1C,KAAK,CAAC,EAAE,MAAM,GACb,WAAW,CA0Cb;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAuB7F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,WAAW,CA4Cb;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,WAAW,EACpB,aAAa,EAAE,OAAO,EACtB,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EACnC,gBAAgB,GAAE,OAAe,GAChC,WAAW,CAoCb;AACD;;;;;GAKG;AAEH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA4BpD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsB5D"}

package/dist/utils/cleanupUtils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Cleanup Utilities
+ *
+ * Consolidated cleanup functions for widget elements and state.
+ * Reduces code duplication across components.
+ */
+/**
+ * Remove tour spotlight and description overlays
+ */
+export declare function cleanupTourElements(): void;
+/**
+ * Remove typewriter cursor styles
+ */
+export declare function cleanupTypewriterStyles(): void;
+/**
+ * Remove all step highlight classes and handlers
+ */
+export declare function cleanupStepHighlights(): void;
+/**
+ * Master cleanup function that removes all widget-related DOM elements
+ * This consolidates cleanup logic from clearChatHistory, removeStepHighlights, etc.
+ */
+export declare function cleanupAllWidgetElements(): void;
+//# sourceMappingURL=cleanupUtils.d.ts.map

package/dist/utils/cleanupUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanupUtils.d.ts","sourceRoot":"","sources":["../../src/utils/cleanupUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAM9C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAM5C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAa/C"}

package/dist/utils/common.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Logger Utility
+ *
+ * Centralized logging utility with log levels and environment-based filtering.
+ * Only logs in development mode to reduce noise in production.
+ */
+/**
+ * Logger interface
+ */
+export declare const logger: {
+    /**
+     * Debug logs - detailed information for debugging
+     */
+    debug: (prefix: string, message: string, ...args: unknown[]) => void;
+    /**
+     * Info logs - general information about application flow
+     */
+    info: (prefix: string, message: string, ...args: unknown[]) => void;
+    /**
+     * Warning logs - potential issues that don't break functionality
+     */
+    warn: (prefix: string, message: string, ...args: unknown[]) => void;
+    /**
+     * Error logs - errors that need attention
+     */
+    error: (prefix: string, message: string, ...args: unknown[]) => void;
+};
+/**
+ * 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;
+    warn: (message: string, ...args: unknown[]) => void;
+    error: (message: string, ...args: unknown[]) => void;
+};
+/**
+ * Execute a function safely with error handling
+ * Returns the result or undefined if an error occurs
+ */
+export declare function safeExecute<T>(fn: () => T, errorMessage: string, defaultValue?: T): T | undefined;
+/**
+ * Execute an async function safely with error handling
+ * Returns the result or undefined if an error occurs
+ */
+export declare function safeExecuteAsync<T>(fn: () => Promise<T>, errorMessage: string, defaultValue?: T): Promise<T | undefined>;
+/**
+ * Centralized error logging
+ */
+export declare function logError(context: string, error: unknown, additionalInfo?: Record<string, unknown>): void;
+/**
+ * Centralized warning logging
+ */
+export declare function logWarning(context: string, message: string, additionalInfo?: Record<string, unknown>): void;
+//# sourceMappingURL=common.d.ts.map

package/dist/utils/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/utils/common.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4CH;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;oBACa,MAAM,WAAW,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;IAMlE;;OAEG;mBACY,MAAM,WAAW,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;IAMjE;;OAEG;mBACY,MAAM,WAAW,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;IAMjE;;OAEG;oBACa,MAAM,WAAW,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;CAKnE,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM;qBAEtB,MAAM,WAAW,OAAO,EAAE;oBAC3B,MAAM,WAAW,OAAO,EAAE;oBAC1B,MAAM,WAAW,OAAO,EAAE;qBACzB,MAAM,WAAW,OAAO,EAAE;EAE9C;AAYD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAOjG;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,YAAY,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,CAAC,GACf,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAOxB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EACd,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,IAAI,CAQN;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,IAAI,CAEN"}

package/dist/utils/config.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Configuration Getters
+ *
+ * Utilities for extracting and formatting configuration values from MarketrixConfig.
+ * These functions provide a clean interface for accessing widget configuration.
+ */
+import type { MarketrixConfig } from '../types';
+export interface WidgetTextConfig {
+    greeting: string;
+    placeholder: string;
+    header_ai: string;
+    header_live: string;
+    body_ai: string;
+    body_live: string;
+    chat_greeting: string;
+    tour_greeting: string;
+}
+export interface WidgetCustomizeConfig {
+    colors: {
+        primary: string;
+        secondary: string;
+        background: string;
+        text: string;
+        border: string;
+    };
+    sizes: {
+        width: string;
+        height: string;
+        border_radius: string;
+        font_size: string;
+    };
+    animations: {
+        slide_duration: string;
+        fade_duration: string;
+        bounce_effect: boolean;
+    };
+}
+export interface WidgetPositionConfig {
+    position: string;
+    offset: {
+        x: number;
+        y: number;
+    };
+    z_index: number;
+}
+/**
+ * Get widget text configuration from MarketrixConfig
+ */
+export declare function getWidgetText(config: MarketrixConfig): WidgetTextConfig;
+/**
+ * Get widget customization configuration from MarketrixConfig
+ */
+export declare function getWidgetCustomize(config: MarketrixConfig): WidgetCustomizeConfig;
+/**
+ * Get widget position configuration from MarketrixConfig
+ */
+export declare function getWidgetPosition(config: MarketrixConfig): WidgetPositionConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,UAAU,EAAE;QACV,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAYvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,qBAAqB,CAsBjF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,oBAAoB,CAa/E"}

package/dist/utils/devTools.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Development Tools - Browser Console Injection
+ *
+ * Exposes widget services on window object for testing in browser console.
+ * Only active in development mode.
+ *
+ * Usage in browser console:
+ *   // Index DOM first
+ *   await devTools.indexDOM()
+ *
+ *   // Test tools
+ *   await devTools.testTool('click_element', { index: 5 })
+ *   await devTools.testTool('type_text', { index: 3, text: 'Hello' })
+ *
+ *   // Direct service access
+ *   domService.getElementByIndex(5)
+ *   toolExecutionService.executeTool('scroll', { direction: 'down' }, 'do')
+ */
+import { type ToolExecutionResult } from '../services/ToolService';
+export declare const TOOL_PARAMS: Record<string, {
+    required: string[];
+    optional: string[];
+}>;
+export declare const devTools: {
+    /**
+     * Index all interactable DOM elements
+     * Must be called before using element-based tools
+     */
+    indexDOM(): Array<[number, Element]>;
+    /**
+     * Get indexed elements list with details
+     */
+    listElements(): void;
+    /**
+     * Highlight an element by index (for visual verification)
+     */
+    highlightElement(index: number, duration?: number): void;
+    /**
+     * Test a tool with given arguments
+     */
+    testTool(toolName: string, args?: Record<string, unknown>, mode?: "do" | "show", explanation?: string): Promise<ToolExecutionResult>;
+    /**
+     * Run a sequence of tools
+     */
+    runSequence(sequence: Array<{
+        tool: string;
+        args?: Record<string, unknown>;
+        delay?: number;
+    }>): Promise<ToolExecutionResult[]>;
+    /**
+     * Get WebSocket connection status
+     */
+    getConnectionStatus(): string;
+    /**
+     * Get chat messages
+     */
+    getMessages(): import("..").ChatMessage[];
+    /**
+     * Clear chat history
+     */
+    clearChat(): void;
+    /**
+     * Print help
+     */
+    help(): void;
+};
+/**
+ * Initialize dev tools - expose on window object
+ */
+export declare function initDevTools(): void;
+//# sourceMappingURL=devTools.d.ts.map

package/dist/utils/devTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devTools.d.ts","sourceRoot":"","sources":["../../src/utils/devTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAAE,KAAK,mBAAmB,EAAwB,MAAM,yBAAyB,CAAC;AAIzF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAmBlF,CAAC;AAGF,eAAO,MAAM,QAAQ;IACnB;;;OAGG;gBACS,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMpC;;OAEG;oBACa,IAAI;IAapB;;OAEG;4BACqB,MAAM,aAAY,MAAM,GAAU,IAAI;IAsB9D;;OAEG;uBAES,MAAM,SACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SACvB,IAAI,GAAG,MAAM,gBACN,MAAM,GAClB,OAAO,CAAC,mBAAmB,CAAC;IAoC/B;;OAEG;0BAES,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAChF,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAuBjC;;OAEG;2BACoB,MAAM;IAK7B;;OAEG;;IAKH;;OAEG;iBACU,IAAI;IAKjB;;OAEG;YACK,IAAI;CAyBb,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAmBnC"}

package/dist/utils/dom.d.ts

@@ -0,0 +1,66 @@
+/**
+ * DOM Manipulation Utilities
+ *
+ * Centralized utilities for common DOM operations to reduce code duplication
+ * and ensure consistent error handling.
+ */
+/**
+ * Safely remove an element by ID
+ */
+export declare function removeElementById(id: string): void;
+/**
+ * Remove tour click handlers from an element
+ */
+export declare function removeTourClickHandler(element: HTMLElement): void;
+/**
+ * Remove all step highlight classes and their associated handlers
+ */
+export declare function removeStepHighlights(): void;
+/**
+ * Get all interactive elements on the page, ordered by DOM position.
+ * Interactive elements include: buttons, inputs, links, select elements, etc.
+ */
+export declare function getAllInteractiveElements(): HTMLElement[];
+/**
+ * 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;
+/**
+ * Get all file input elements on the page, ordered by DOM position.
+ */
+export declare function getAllFileInputs(): HTMLInputElement[];
+/**
+ * Get a file input element by its index.
+ */
+export declare function getFileInputByIndex(index: number): HTMLInputElement | null;
+/**
+ * Get all select/dropdown elements on the page, ordered by DOM position.
+ */
+export declare function getAllSelectElements(): HTMLSelectElement[];
+/**
+ * Get a select element by its index.
+ */
+export declare function getSelectElementByIndex(index: number): HTMLSelectElement | null;
+export declare function isInteractable(el: Element | null): boolean;
+/**
+ * Attribute Parsing Utilities
+ *
+ * Pure utility functions for parsing script tag data attributes.
+ * These functions validate and normalize attribute values.
+ */
+/**
+ * Parse position attribute from script tag
+ */
+export declare function parsePositionAttribute(value: string | null): 'bottom_right' | 'bottom_left';
+/**
+ * Parse theme attribute from script tag
+ */
+export declare function parseThemeAttribute(value: string | null): 'light' | 'dark';
+/**
+ * Parse enabled modes attribute from script tag
+ */
+export declare function parseEnabledModesAttribute(value: string | null): ('show' | 'tell' | 'do')[];
+//# sourceMappingURL=dom.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/utils/dom.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CASlD;AAkBD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAQjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAY3C;AAQD;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,WAAW,EAAE,CA0CzD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAiBnE;AAiCD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,EAAE,CAGrD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAM1E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,EAAE,CAG1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAM/E;AACD,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAsN1D;AACD;;;;;GAKG;AAEH;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,GAAG,aAAa,CAK3F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,CAK1E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,CAe3F"}

package/dist/utils/format.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 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;
+/**
+ * Lightens a color by a specified amount (0-1)
+ */
+export declare function lightenColor(color: string, amount: number): string;
+/**
+ * Extracts the first color from a gradient string, or returns the color as-is
+ */
+export declare function extractColorFromGradient(color: string): string;
+export declare const formatMessageTime: (date: Date | undefined) => string;
+export declare const getModeDisplayName: (mode: "show" | "tell" | "do") => string;
+export declare const getModeDescription: (mode: "show" | "tell" | "do") => string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAShF;AAwBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAyBjE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUlE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkB9D;AACD,eAAO,MAAM,iBAAiB,GAAI,MAAM,IAAI,GAAG,SAAS,KAAG,MAK1D,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,KAAG,MAWjE,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,KAAG,MAWjE,CAAC"}

package/dist/utils/persistence.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Persistence utilities for bookmarklet usage
+ * Handles storing and restoring widget configuration for bookmarklet scenarios
+ */
+/**
+ * Check if there's a stored bookmarklet config and re-inject the widget
+ * This is called on page load to restore widget state from bookmarklet usage
+ */
+export declare const checkAndReinjectOnLoad: () => void;
+/**
+ * Initialize persistence for bookmarklet usage
+ * Sets up storage mechanism for widget configuration
+ */
+export declare const initializePersistence: () => void;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/utils/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/utils/persistence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAO,IAoBzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAO,IAMxC,CAAC"}

package/dist/utils/stateUtils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * State Update Utilities
+ *
+ * Helper functions for common state update patterns to reduce code duplication.
+ */
+import type React from 'react';
+import type { ChatMessage, WidgetState } from '../types';
+/**
+ * Add a message to the state
+ */
+export declare function addMessage(setState: React.Dispatch<React.SetStateAction<WidgetState>>, message: ChatMessage): void;
+/**
+ * Update a specific message in the state
+ */
+export declare function updateMessage(setState: React.Dispatch<React.SetStateAction<WidgetState>>, messageId: string, updates: Partial<ChatMessage>): void;
+/**
+ * Remove a message from the state
+ */
+export declare function removeMessage(setState: React.Dispatch<React.SetStateAction<WidgetState>>, messageId: string): void;
+//# sourceMappingURL=stateUtils.d.ts.map

package/dist/utils/stateUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateUtils.d.ts","sourceRoot":"","sources":["../../src/utils/stateUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEzD;;GAEG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,EAC3D,OAAO,EAAE,WAAW,GACnB,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,EAC3D,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,EAC3D,SAAS,EAAE,MAAM,GAChB,IAAI,CAKN"}