@marketrix.ai/widget 1.0.13 → 1.0.15

package/dist/utils/apiUtils.d.ts

@@ -0,0 +1,56 @@
+/**
+ * API Utilities
+ *
+ * Consolidates API response validation, data extraction, and error handling patterns.
+ * Eliminates repetition of response validation and error handling across services.
+ */
+import type { MarketrixConfig } from '../types';
+/**
+ * API Response Body structure (matches SDK's ResBody interface)
+ */
+interface ApiResponseBody<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    message?: string;
+}
+/**
+ * Generic API response type - flexible to handle SDK union types
+ */
+type ApiResponse<T = unknown> = {
+    status: number;
+    body?: ApiResponseBody<T> | null | unknown;
+    [key: string]: unknown;
+};
+/**
+ * Validate API response structure
+ * Consolidates the repeated pattern: response.status === 200 && response.body?.success
+ */
+export declare function isValidApiResponse<T = unknown>(response: ApiResponse<T>): response is ApiResponse<T> & {
+    status: 200;
+    body: ApiResponseBody<T>;
+};
+/**
+ * Extract data from API response with validation
+ * Consolidates the pattern: isValidApiResponse(response) && response.body.data
+ */
+export declare function extractApiData<T>(response: ApiResponse<T>): T | null;
+/**
+ * Check if error is a connection/network error
+ * Consolidates the repeated pattern across widgetValidationService and other services
+ */
+export declare function isConnectionError(error: unknown): boolean;
+/**
+ * Extract error message from unknown error type
+ * 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;
+};
+export {};
+//# sourceMappingURL=apiUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apiUtils.d.ts","sourceRoot":"","sources":["../../src/utils/apiUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAMhD;;GAEG;AACH,UAAU,eAAe,CAAC,CAAC,GAAG,OAAO;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,KAAK,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC;IAC3C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAC5C,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GACvB,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CAAE,CAGxE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAQpE;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQzD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAkB,GAAG,MAAM,CAQtF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,SAAc,EACrB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC;IACD,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAgBA"}

package/dist/utils/bootstrap.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 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 - 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;
+/**
+ * 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
+ * Retries if script tag not found to handle timing issues with ES module loading
+ */
+export declare const autoInitializeWidget: (retryCount?: number) => void;
+/**
+ * Register the widget initialization function and set up auto-initialization
+ *
+ * @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;AAsBhD;;;;;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;CA2DtB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,WAAW,EAAE,QAAQ,eAAe,KAAG,IAatF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,WAAW,WAAW,KAAG,IAK/D,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,IA0C3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAAO,IAU3C,CAAC;AAWF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,mBAAc,KAAG,IA0GrD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,YAAY,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,KAAG,IASzF,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,CA8IP;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,CAkCb;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;AAIH;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAS/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;AAyCH;;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/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,CAiBnC"}

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,6 @@
+/**
+ * Persistence utilities
+ * Currently, persistence is handled by ConfigManager
+ * This file is kept for potential future persistence needs
+ */
+//# 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;;;;GAIG"}

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"}