@marketrix.ai/widget 3.8.53 → 3.8.134

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

@@ -14,7 +14,6 @@ export interface IconData {
     paths: IconPath[];
 }
 export declare const icons: {
-    /** FaCheckCircle */
     readonly checkCircle: {
         readonly viewBox: "0 0 512 512";
         readonly paths: [{
@@ -22,7 +21,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** FaCircle */
     readonly circle: {
         readonly viewBox: "0 0 512 512";
         readonly paths: [{
@@ -30,7 +28,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** FaExclamationCircle */
     readonly exclamationCircle: {
         readonly viewBox: "0 0 512 512";
         readonly paths: [{
@@ -38,7 +35,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** FaTimesCircle */
     readonly timesCircle: {
         readonly viewBox: "0 0 512 512";
         readonly paths: [{
@@ -46,7 +42,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** FaBan */
     readonly ban: {
         readonly viewBox: "0 0 512 512";
         readonly paths: [{
@@ -54,7 +49,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** FaArrowUp */
     readonly arrowUp: {
         readonly viewBox: "0 0 448 512";
         readonly paths: [{
@@ -62,7 +56,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** FaArrowDown */
     readonly arrowDown: {
         readonly viewBox: "0 0 448 512";
         readonly paths: [{
@@ -70,7 +63,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** FiX */
     readonly x: {
         readonly viewBox: "0 0 24 24";
         readonly paths: [{
@@ -89,7 +81,6 @@ export declare const icons: {
             readonly strokeLinejoin: "round";
         }];
     };
-    /** IoChatbubbleEllipsesOutline */
     readonly chatBubble: {
         readonly viewBox: "0 0 512 512";
         readonly paths: [{
@@ -109,7 +100,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** IoStop */
     readonly stop: {
         readonly viewBox: "0 0 512 512";
         readonly paths: [{
@@ -117,7 +107,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** LuMousePointerClick */
     readonly mousePointerClick: {
         readonly viewBox: "0 0 24 24";
         readonly paths: [{
@@ -157,7 +146,6 @@ export declare const icons: {
             readonly strokeLinejoin: "round";
         }];
     };
-    /** SiTicktick */
     readonly ticktick: {
         readonly viewBox: "0 0 24 24";
         readonly paths: [{

package/dist/src/index.d.ts

@@ -33,10 +33,6 @@ export { getCurrentConfig };
  * Renders widget into parent container with shadow DOM
  */
 export declare const MarketrixWidget: React.FC<MarketrixWidgetProps>;
-/**
- * addWidget - Function that auto-detects mode and initializes widget
- * Supports preview, production, and dev modes
- */
 export declare const mountWidget: (config: AddWidgetConfig) => Promise<void>;
 export type { InstructionType } from './sdk';
 export type { AddWidgetConfig, ChatMessage, MarketrixConfig, MarketrixWidgetProps, WidgetState } from './types';

package/dist/src/sdk/contract.d.ts

@@ -388,7 +388,7 @@ export declare const widgetContract: {
         error: string;
     } | {
         type: "task/status";
-        status: "completed" | "failed" | "running" | "has_question" | "stopped";
+        status: "running" | "has_question" | "completed" | "failed" | "stopped";
         message?: string | undefined;
         task_id?: string | undefined;
         timestamp?: number | undefined;
@@ -419,7 +419,7 @@ export declare const widgetContract: {
         error: string;
     } | {
         type: "task/status";
-        status: "completed" | "failed" | "running" | "has_question" | "stopped";
+        status: "running" | "has_question" | "completed" | "failed" | "stopped";
         message?: string | undefined;
         task_id?: string | undefined;
         timestamp?: number | undefined;

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

@@ -16,20 +16,13 @@ export declare const KnowledgeSourceSchema: z.ZodEnum<{
     research: "research";
 }>;
 export type KnowledgeSource = z.infer<typeof KnowledgeSourceSchema>;
-export declare const QAFlowStatusSchema: z.ZodEnum<{
-    pending: "pending";
-    processing: "processing";
-    waiting_review: "waiting_review";
-    completed: "completed";
-    failed: "failed";
-}>;
 export declare const SimulationStatusSchema: z.ZodEnum<{
-    completed: "completed";
-    failed: "failed";
     queued: "queued";
     running: "running";
     creating_knowledge: "creating_knowledge";
     has_question: "has_question";
+    completed: "completed";
+    failed: "failed";
     stopped: "stopped";
 }>;
 export type SimulationStatus = z.infer<typeof SimulationStatusSchema>;
@@ -39,9 +32,9 @@ export type SimulationStatus = z.infer<typeof SimulationStatusSchema>;
  * `simulation/graph-updated` app event.
  */
 export declare const GraphStatusSchema: z.ZodEnum<{
-    pending: "pending";
     completed: "completed";
     failed: "failed";
+    pending: "pending";
     generating: "generating";
 }>;
 export declare const ApplicationTypeSchema: z.ZodEnum<{
@@ -172,15 +165,20 @@ export declare const KnowledgeEntitySchema: z.ZodObject<{
 }, z.core.$strip>;
 export type KnowledgeData = z.infer<typeof KnowledgeEntitySchema>;
 /**
- * QA verdict entity schemas — LLM evaluator output per (qa_run, qa_test_case).
- * Independent of simulation task status (which keeps raw execution semantics).
+ * Device viewport — the only device dimension (Chrome-only). A simulation runs at exactly
+ * one viewport; selecting N viewports fans out into N simulations (one per viewport).
+ * Defined here (the widget/root import closure) so SSE + simulation + qa contracts can share it.
  */
-export declare const QAVerdictSchema: z.ZodEnum<{
-    failed: "failed";
-    passed: "passed";
-    needs_healing: "needs_healing";
+export declare const ViewportNameSchema: z.ZodEnum<{
+    desktop: "desktop";
+    tablet: "tablet";
+    mobile: "mobile";
+}>;
+export type ViewportName = z.infer<typeof ViewportNameSchema>;
+export declare const VIEWPORT_DIMENSIONS: Record<ViewportName, {
+    width: number;
+    height: number;
 }>;
-export type QAVerdict = z.infer<typeof QAVerdictSchema>;
 export declare const QAProcessResponseSchema: z.ZodObject<{
     ultimate_goal: z.ZodString;
     test_cases: z.ZodArray<z.ZodObject<{
@@ -218,11 +216,11 @@ export declare const SimulationTaskEntrySchema: z.ZodObject<{
     title: z.ZodString;
     instructions: z.ZodString;
     status: z.ZodEnum<{
-        pending: "pending";
-        failed: "failed";
         running: "running";
         has_question: "has_question";
+        failed: "failed";
         stopped: "stopped";
+        pending: "pending";
         passed: "passed";
         skipped: "skipped";
     }>;
@@ -240,6 +238,62 @@ export declare const SimulationTaskEntrySchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type SimulationTaskEntry = z.infer<typeof SimulationTaskEntrySchema>;
+export declare const SentimentSchema: z.ZodEnum<{
+    positive: "positive";
+    neutral: "neutral";
+    negative: "negative";
+}>;
+export declare const StepReactionSchema: z.ZodObject<{
+    step_index: z.ZodNumber;
+    screenshot_ref: z.ZodNullable<z.ZodString>;
+    reaction: z.ZodString;
+    sentiment: z.ZodNullable<z.ZodEnum<{
+        positive: "positive";
+        neutral: "neutral";
+        negative: "negative";
+    }>>;
+}, z.core.$strip>;
+export declare const JourneyReactionSchema: z.ZodObject<{
+    reaction: z.ZodString;
+    sentiment: z.ZodEnum<{
+        positive: "positive";
+        neutral: "neutral";
+        negative: "negative";
+    }>;
+}, z.core.$strip>;
+export declare const PersonaSimReactionEntitySchema: z.ZodObject<{
+    id: z.ZodNumber;
+    run_id: z.ZodNullable<z.ZodNumber>;
+    persona_id: z.ZodNullable<z.ZodNumber>;
+    user_index: z.ZodNullable<z.ZodNumber>;
+    simulation_id: z.ZodNullable<z.ZodNumber>;
+    study_variant_id: z.ZodNullable<z.ZodNumber>;
+    journey_reaction: z.ZodNullable<z.ZodString>;
+    journey_sentiment: z.ZodNullable<z.ZodEnum<{
+        positive: "positive";
+        neutral: "neutral";
+        negative: "negative";
+    }>>;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        pending: "pending";
+    }>;
+    step_reactions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        step_index: z.ZodNumber;
+        screenshot_ref: z.ZodNullable<z.ZodString>;
+        reaction: z.ZodString;
+        sentiment: z.ZodNullable<z.ZodEnum<{
+            positive: "positive";
+            neutral: "neutral";
+            negative: "negative";
+        }>>;
+    }, z.core.$strip>>>;
+    question_answers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        study_question_id: z.ZodNumber;
+        answer: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 export declare const SimulationEntitySchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodNumber>;
     created_at: z.ZodOptional<z.ZodCoercedDate<unknown>>;
@@ -248,17 +302,25 @@ export declare const SimulationEntitySchema: z.ZodObject<{
     job_id: z.ZodString;
     browser_session_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     status: z.ZodEnum<{
-        completed: "completed";
-        failed: "failed";
         queued: "queued";
         running: "running";
         creating_knowledge: "creating_knowledge";
         has_question: "has_question";
+        completed: "completed";
+        failed: "failed";
         stopped: "stopped";
     }>;
     status_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     instructions: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        direct: "direct";
+        uxr: "uxr";
+        survey: "survey";
+        ab: "ab";
+        qa: "qa";
+    }>>>;
     pinned: z.ZodOptional<z.ZodBoolean>;
     source: z.ZodOptional<z.ZodEnum<{
         direct: "direct";
@@ -271,11 +333,11 @@ export declare const SimulationEntitySchema: z.ZodObject<{
         title: z.ZodString;
         instructions: z.ZodString;
         status: z.ZodEnum<{
-            pending: "pending";
-            failed: "failed";
             running: "running";
             has_question: "has_question";
+            failed: "failed";
             stopped: "stopped";
+            pending: "pending";
             passed: "passed";
             skipped: "skipped";
         }>;
@@ -293,17 +355,59 @@ export declare const SimulationEntitySchema: z.ZodObject<{
         }, z.core.$strip>>>;
     }, z.core.$strip>>>;
     graph_status: z.ZodOptional<z.ZodEnum<{
-        pending: "pending";
         completed: "completed";
         failed: "failed";
+        pending: "pending";
         generating: "generating";
     }>>;
     graph_steps_processed: z.ZodOptional<z.ZodNumber>;
     graph_steps_total: z.ZodOptional<z.ZodNumber>;
     graph_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     created_by_user_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    persona_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     has_question: z.ZodOptional<z.ZodBoolean>;
+    participants: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        persona_id: z.ZodNumber;
+        user_count: z.ZodNumber;
+    }, z.core.$strip>>>;
+    reactions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        run_id: z.ZodNullable<z.ZodNumber>;
+        persona_id: z.ZodNullable<z.ZodNumber>;
+        user_index: z.ZodNullable<z.ZodNumber>;
+        simulation_id: z.ZodNullable<z.ZodNumber>;
+        study_variant_id: z.ZodNullable<z.ZodNumber>;
+        journey_reaction: z.ZodNullable<z.ZodString>;
+        journey_sentiment: z.ZodNullable<z.ZodEnum<{
+            positive: "positive";
+            neutral: "neutral";
+            negative: "negative";
+        }>>;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            pending: "pending";
+        }>;
+        step_reactions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            step_index: z.ZodNumber;
+            screenshot_ref: z.ZodNullable<z.ZodString>;
+            reaction: z.ZodString;
+            sentiment: z.ZodNullable<z.ZodEnum<{
+                positive: "positive";
+                neutral: "neutral";
+                negative: "negative";
+            }>>;
+        }, z.core.$strip>>>;
+        question_answers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            study_question_id: z.ZodNumber;
+            answer: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    driver_persona_id: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    viewport: z.ZodDefault<z.ZodEnum<{
+        desktop: "desktop";
+        tablet: "tablet";
+        mobile: "mobile";
+    }>>;
 }, z.core.$strip>;
 export type SimulationData = z.infer<typeof SimulationEntitySchema>;
 export declare const ApplicationEntitySchema: z.ZodObject<{
@@ -481,21 +585,31 @@ export declare const StateTriggerEntitySchema: z.ZodObject<{
 }, z.core.$strip>;
 export type StateTriggerData = z.infer<typeof StateTriggerEntitySchema>;
 /**
- * QA run derived status — set by `deriveQARunStats` based on aggregated
- * task states. Emitted by the API on `qa-run/updated` events and returned
- * in QA run oRPC payloads.
- *
- * Canonical wire vocabulary; `deriveQARunStats` returns `'running'` directly.
- * `'pending'` is the empty-task initial state.
+ * QA run status — first-class TEXT+CHECK column on qa_run (no longer derived).
+ * `synthesizing` = all sims terminal but per-journey verdicts still completing (QA has no
+ * run-level rollup like studies). Canonical wire vocabulary.
  */
 export declare const QARunStatusSchema: z.ZodEnum<{
-    pending: "pending";
+    running: "running";
     completed: "completed";
     failed: "failed";
-    running: "running";
     stopped: "stopped";
+    synthesizing: "synthesizing";
 }>;
 export type QARunStatus = z.infer<typeof QARunStatusSchema>;
+/** QA verdict per (run, persona, journey, viewport) — DATA-derived by the api from qa_verdict; NOT a wire status. */
+export declare const QARunVerdictStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    passed: "passed";
+    indecisive: "indecisive";
+}>;
+export type QARunVerdictStatus = z.infer<typeof QARunVerdictStatusSchema>;
+/** A human resolution of an indecisive verdict — resolves to a decision, so no `indecisive`. */
+export declare const HumanRulingSchema: z.ZodEnum<{
+    failed: "failed";
+    passed: "passed";
+}>;
+export type HumanRuling = z.infer<typeof HumanRulingSchema>;
 export declare const ActionLogTypeSchema: z.ZodEnum<{
     user_login: "user_login";
     url_visit: "url_visit";
@@ -664,12 +778,12 @@ export declare const SuggestedSimulationSchema: z.ZodObject<{
     simulation_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     task_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        completed: "completed";
-        failed: "failed";
         queued: "queued";
         running: "running";
         creating_knowledge: "creating_knowledge";
         has_question: "has_question";
+        completed: "completed";
+        failed: "failed";
         stopped: "stopped";
     }>>>;
 }, z.core.$strip>;

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

@@ -366,10 +366,10 @@ export declare const WidgetEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"task/status">;
     status: z.ZodEnum<{
-        completed: "completed";
-        failed: "failed";
         running: "running";
         has_question: "has_question";
+        completed: "completed";
+        failed: "failed";
         stopped: "stopped";
     }>;
     message: z.ZodOptional<z.ZodString>;
@@ -850,7 +850,7 @@ export declare const widgetStream: import("@orpc/contract").ContractProcedureBui
     error: string;
 } | {
     type: "task/status";
-    status: "completed" | "failed" | "running" | "has_question" | "stopped";
+    status: "running" | "has_question" | "completed" | "failed" | "stopped";
     message?: string | undefined;
     task_id?: string | undefined;
     timestamp?: number | undefined;
@@ -881,7 +881,7 @@ export declare const widgetStream: import("@orpc/contract").ContractProcedureBui
     error: string;
 } | {
     type: "task/status";
-    status: "completed" | "failed" | "running" | "has_question" | "stopped";
+    status: "running" | "has_question" | "completed" | "failed" | "stopped";
     message?: string | undefined;
     task_id?: string | undefined;
     timestamp?: number | undefined;
@@ -1360,7 +1360,7 @@ export declare const widgetRoutes: {
         error: string;
     } | {
         type: "task/status";
-        status: "completed" | "failed" | "running" | "has_question" | "stopped";
+        status: "running" | "has_question" | "completed" | "failed" | "stopped";
         message?: string | undefined;
         task_id?: string | undefined;
         timestamp?: number | undefined;
@@ -1391,7 +1391,7 @@ export declare const widgetRoutes: {
         error: string;
     } | {
         type: "task/status";
-        status: "completed" | "failed" | "running" | "has_question" | "stopped";
+        status: "running" | "has_question" | "completed" | "failed" | "stopped";
         message?: string | undefined;
         task_id?: string | undefined;
         timestamp?: number | undefined;

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

@@ -393,7 +393,7 @@ export declare const sdk: {
         error: string;
     } | {
         type: "task/status";
-        status: "completed" | "failed" | "running" | "has_question" | "stopped";
+        status: "running" | "has_question" | "completed" | "failed" | "stopped";
         message?: string | undefined;
         task_id?: string | undefined;
         timestamp?: number | undefined;
@@ -424,7 +424,7 @@ export declare const sdk: {
         error: string;
     } | {
         type: "task/status";
-        status: "completed" | "failed" | "running" | "has_question" | "stopped";
+        status: "running" | "has_question" | "completed" | "failed" | "stopped";
         message?: string | undefined;
         task_id?: string | undefined;
         timestamp?: number | undefined;

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

@@ -2,17 +2,11 @@ import type { MarketrixConfig, SendMessageRequest, SendMessageResponse } from '.
 export declare class ApiService {
     private config;
     constructor(config: MarketrixConfig);
-    /**
-     * Get the current chat ID (does not create if missing)
-     */
     getChatId(): string | null;
     /**
      * Get user_id from various sources (config, localStorage, sessionStorage)
      */
     private getUserId;
-    /**
-     * Log widget question to action_log
-     */
     logWidgetQuestion(question: string, mode: string): Promise<void>;
     /**
      * Send a message via the typed stream (fire-and-forget).

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;
 }
@@ -43,13 +31,7 @@ export declare class DomService {
     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.
@@ -66,29 +48,14 @@ export declare class DomService {
      * 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;

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

@@ -22,9 +22,6 @@ import type { ChatMessage, InstructionType, MarketrixConfig } from '../types';
 type StoredMessage = Omit<ChatMessage, 'videoStream' | 'timestamp'> & {
     timestamp: string;
 };
-/**
- * Unified storage structure for all widget data
- */
 export interface MarketrixChatContext {
     chat_id: string | null;
     messages: StoredMessage[];
@@ -48,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
@@ -85,9 +67,6 @@ declare class StorageService {
     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;