@marketrix.ai/widget 3.8.490 → 3.8.492

package/README.md

@@ -131,7 +131,7 @@ import {
   unmountWidget,
   updateMarketrixConfig,
   getCurrentConfig,
-  MarketrixWidget,
+  MarketrixWidgetPreview,
 } from '@marketrix.ai/widget';
 ```
 
@@ -182,16 +182,16 @@ When recording is enabled, **every input value is masked** — recordings captur
 
 Both the `mtx-` and rrweb's native `rr-` prefixes are honoured, so existing `rr-block` / `rr-mask` markup keeps working.
 
-### `MarketrixWidget` — React component (preview)
+### `MarketrixWidgetPreview` — React component
 
 For previewing appearance inside a React app (e.g. a settings/configuration screen). Renders into its own Shadow DOM and makes no network calls.
 
 ```tsx
-import { MarketrixWidget } from '@marketrix.ai/widget';
+import { MarketrixWidgetPreview } from '@marketrix.ai/widget';
 
 function Preview() {
   return (
-    <MarketrixWidget
+    <MarketrixWidgetPreview
       settings={{ widget_enabled: true, widget_position: 'bottom_right' /* ...WidgetSettingsData */ }}
       mtxApiHost='https://api.marketrix.ai'
     />
@@ -217,7 +217,7 @@ TypeScript types are bundled with the package:
 
 - `MarketrixConfig` — full config for `initWidget` / `updateMarketrixConfig` (`mtxId`, `mtxKey`, `mtxApiHost`, `userId`, `show_widget`, `use_screenshare`, plus all widget appearance settings, optional).
 - `AddWidgetConfig` — discriminated config for `mountWidget` (production / preview variants + common options).
-- `MarketrixWidgetProps` — props for the `MarketrixWidget` component.
+- `MarketrixWidgetPreviewProps` — props for the `MarketrixWidgetPreview` component.
 - `ChatMessage`, `WidgetState`, `InstructionType` (`'tell' | 'show' | 'do'`).
 
 ---

package/dist/src/components/WidgetRoot.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
-import type { MarketrixConfig } from '../types';
+import type { ValidWidgetConfig } from '../types';
 interface WidgetRootProps {
-    config: MarketrixConfig;
+    config: ValidWidgetConfig;
 }
 export declare const WidgetRoot: React.FC<WidgetRootProps>;
 export {};

package/dist/src/components/chat/VideoStreamDisplay.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 interface VideoStreamDisplayProps {
-    stream: MediaStream | null;
+    stream: MediaStream;
 }
 export declare const VideoStreamDisplay: React.FC<VideoStreamDisplayProps>;
 export {};

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

@@ -3,6 +3,7 @@ import { type ChatMessage, type InstructionType } from '../types';
 export type TaskPhase = 'idle' | 'running' | 'stopped';
 export interface TaskState {
     phase: TaskPhase;
+    mode?: InstructionType;
 }
 export interface SseState {
     messages: ChatMessage[];

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

@@ -1,6 +1,4 @@
-import type { MarketrixConfig, WidgetState } from '../types';
-import type { WidgetRenderedSettings } from '../utils/validation';
-export type ValidWidgetConfig = MarketrixConfig & Required<Pick<MarketrixConfig, keyof WidgetRenderedSettings>>;
+import type { ValidWidgetConfig, WidgetState } from '../types';
 /** Every setting resolved: API settings plus the position and script-tag overrides WidgetRoot layers on top. */
 export declare const WidgetConfigContext: import("react").Context<ValidWidgetConfig | null>;
 export declare const useWidgetConfig: () => ValidWidgetConfig;

package/dist/src/index.d.ts

@@ -6,7 +6,7 @@ declare global {
     }
 }
 import React from 'react';
-import type { AddWidgetConfig, ClientOwnedConfig, MarketrixConfig, MarketrixWidgetProps } from './types';
+import type { AddWidgetConfig, ClientOwnedConfig, MarketrixConfig, MarketrixWidgetPreviewProps, ValidWidgetConfig } from './types';
 import { getCurrentConfig } from './utils/bootstrap';
 export declare const initWidget: (config: MarketrixConfig, container?: HTMLElement) => Promise<void>;
 export declare const unmountWidget: () => void;
@@ -15,12 +15,12 @@ export declare const updateMarketrixConfig: (newConfig: ClientOwnedConfig & {
     mtxKey?: string;
 }) => Promise<void>;
 export { getCurrentConfig };
-export declare const MarketrixWidget: React.FC<MarketrixWidgetProps>;
+export declare const MarketrixWidgetPreview: React.FC<MarketrixWidgetPreviewProps>;
 export declare const mountWidget: (config: AddWidgetConfig) => Promise<void>;
 export type { InstructionType } from './sdk';
-export type { AddWidgetConfig, ChatMessage, ClientOwnedConfig, MarketrixConfig, MarketrixWidgetProps, WidgetState, } from './types';
+export type { AddWidgetConfig, ChatMessage, ClientOwnedConfig, MarketrixConfig, MarketrixWidgetPreviewProps, WidgetState, } from './types';
 declare const _default: {
-    MarketrixWidget: React.FC<MarketrixWidgetProps>;
+    MarketrixWidgetPreview: React.FC<MarketrixWidgetPreviewProps>;
     mountWidget: (config: AddWidgetConfig) => Promise<void>;
     initWidget: (config: MarketrixConfig, container?: HTMLElement) => Promise<void>;
     unmountWidget: () => void;
@@ -28,6 +28,6 @@ declare const _default: {
         mtxId?: string;
         mtxKey?: string;
     }) => Promise<void>;
-    getCurrentConfig: () => MarketrixConfig | null;
+    getCurrentConfig: () => ValidWidgetConfig | null;
 };
 export default _default;

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

@@ -1,3 +1,4 @@
+import type { InstructionType } from '../types';
 export interface TextData {
     text: string;
 }
@@ -16,14 +17,17 @@ export interface DropdownOptionsData {
         text: string;
     }>;
 }
-export interface ToolExecutionResult<T = TextData> {
-    success: boolean;
+type ToolFailure = {
+    success: false;
+    error: string;
+};
+export type ToolExecutionResult<T = TextData> = {
+    success: true;
     data: T;
-    error?: string;
     afterResponseAttempt?: () => void;
-}
+} | ToolFailure;
 export declare class BrowserToolService {
-    executeTool(browserToolName: string, args: Record<string, unknown>, mode?: string, explanation?: string): Promise<ToolExecutionResult<unknown>>;
+    executeTool(browserToolName: string, args: Record<string, unknown>, mode: InstructionType, explanation?: string): Promise<ToolExecutionResult<unknown>>;
     private navigate;
     private search;
     private clickElement;
@@ -47,3 +51,4 @@ export declare class BrowserToolService {
     private getScreenshot;
 }
 export declare const browserToolService: BrowserToolService;
+export {};

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

@@ -1,12 +1,4 @@
-import type { ChatMessage, InstructionType } from '../types';
-import { type ChatSnapshot } from './StorageService';
-export declare class ChatService {
-    restore(): ChatSnapshot;
-    persist(snapshot: ChatSnapshot): void;
-}
-export declare const chatService: ChatService;
-export declare const createUserMessage: (content: string, mode?: InstructionType, idPrefix?: string) => ChatMessage;
-export declare const createAgentMessage: (content: string) => ChatMessage;
-export declare const createSystemMessage: (content: string, mode: InstructionType, sender: "user" | "agent", idPrefix: string) => ChatMessage;
-export declare const createScreenAccessRequestMessage: (mode: InstructionType | undefined, pendingContent?: string) => ChatMessage;
-export declare const createScreenshareMessage: (stream: MediaStream, mode?: InstructionType) => ChatMessage;
+import { type InstructionType } from '../sdk';
+import { type CredentialedConfig } from './StorageService';
+/** The reply does not come back from here — it arrives asynchronously as a chat/response event on the stream. */
+export declare function chatPost(config: CredentialedConfig, message: string, mode: InstructionType, requestId: string): Promise<void>;

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

@@ -1,4 +1,4 @@
-import type { ChatMessage, InstructionType, MarketrixConfig } from '../types';
+import type { ChatMessage, InstructionType, MarketrixConfig, ValidWidgetConfig } from '../types';
 export type StoredMessage = Omit<ChatMessage, 'videoStream' | 'timestamp'> & {
     timestamp: string;
 };
@@ -7,7 +7,7 @@ export interface ChatSnapshot {
     currentMode: InstructionType;
     isOpen: boolean;
 }
-export type CredentialedConfig = MarketrixConfig & {
+export type CredentialedConfig = ValidWidgetConfig & {
     mtxId: string;
     mtxKey: string;
 };
@@ -32,4 +32,6 @@ declare class StorageService {
     setConfig(config: CredentialedConfig): void;
 }
 export declare const storageService: StorageService;
+export declare function readChatSnapshot(): ChatSnapshot;
+export declare function writeChatSnapshot(snapshot: ChatSnapshot): void;
 export {};

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

@@ -1,6 +1,5 @@
-import { type WidgetSettingsData } from '../sdk';
-import type { MarketrixConfig } from '../types';
+import type { MarketrixConfig, ValidWidgetConfig } from '../types';
 import { type WidgetRenderedSettings } from '../utils/validation';
 import type { CredentialedConfig } from './StorageService';
-export declare function createConfigFromSettings(widgetSettings: WidgetSettingsData | WidgetRenderedSettings, baseConfig?: Partial<MarketrixConfig>): MarketrixConfig;
+export declare function createConfigFromSettings(widgetSettings: WidgetRenderedSettings, baseConfig?: Partial<MarketrixConfig>): ValidWidgetConfig;
 export declare function loadWidgetConfig(config: MarketrixConfig): Promise<CredentialedConfig>;

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

@@ -16,6 +16,8 @@ export type MarketrixConfig = Partial<WidgetRenderedSettings> & ClientOwnedConfi
     mtxApp?: number;
     isPreviewMode?: boolean;
 };
+/** A MarketrixConfig that has been through parseWidgetSettings — every rendered setting present. */
+export type ValidWidgetConfig = MarketrixConfig & Required<Pick<MarketrixConfig, keyof WidgetRenderedSettings>>;
 export interface ChatMessage {
     id: string;
     content: string;
@@ -66,7 +68,7 @@ export type AddWidgetConfig = ({
 }) & ClientOwnedConfig & {
     container?: HTMLElement;
 };
-export interface MarketrixWidgetProps {
+export interface MarketrixWidgetPreviewProps {
     settings: WidgetSettingsData;
     container?: HTMLElement;
 }

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

@@ -1,9 +1,9 @@
 import { type Root } from 'react-dom/client';
 import type { NotificationTone } from '../design-system/component-tokens';
-import type { MarketrixConfig } from '../types';
+import type { MarketrixConfig, ValidWidgetConfig } from '../types';
 export interface WidgetMount {
     instance: Root;
-    config: MarketrixConfig;
+    config: ValidWidgetConfig;
     container: HTMLElement;
     host: HTMLElement | undefined;
     previewMode: boolean;
@@ -16,9 +16,9 @@ export declare const createWidgetContainer: (parentContainer?: HTMLElement) => {
     shadowRoot: ShadowRoot;
     mountEl: HTMLElement;
 };
-export declare const mountWidgetToContainer: (mountEl: HTMLElement, config: MarketrixConfig, previewMode?: boolean) => Root;
+export declare const mountWidgetToContainer: (mountEl: HTMLElement, config: ValidWidgetConfig, previewMode?: boolean) => Root;
 export declare const isWidgetInitialized: () => boolean;
-export declare const getCurrentConfig: () => MarketrixConfig | null;
+export declare const getCurrentConfig: () => ValidWidgetConfig | null;
 export declare const showHostPageNotice: (message: string, tone?: NotificationTone) => void;
 export declare const hideHostPageNotice: () => void;
 export declare const autoInitializeWidget: (initWidget: (config: MarketrixConfig) => Promise<void>) => void;

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

@@ -18,3 +18,8 @@ export declare const markProgressLineComplete: (message: ChatMessage, browserToo
 export declare function markProgressLineFailed(message: ChatMessage, browserToolName: string, error: string): ChatMessage;
 export declare const TOOL_LABELS: Map<string, string>;
 export declare const getFriendlyToolName: (browserToolName: string) => string;
+export declare const createUserMessage: (content: string, mode?: InstructionType, idPrefix?: string) => ChatMessage;
+export declare const createAgentMessage: (content: string) => ChatMessage;
+export declare const createSystemMessage: (content: string, idPrefix: string) => ChatMessage;
+export declare const createScreenAccessRequestMessage: (mode: InstructionType | undefined, pendingContent?: string) => ChatMessage;
+export declare const createScreenshareMessage: (stream: MediaStream, mode?: InstructionType) => ChatMessage;