@modelnex/sdk 0.5.3 → 0.5.6

package/README.md

@@ -1,6 +1,6 @@
 # @modelnex/sdk
 
-React SDK for ModelNex agent chat, tours, and guided onboarding.
+React SDK for ModelNex agent chat, tours, and workflows.
 
 ## Install
 
@@ -33,9 +33,6 @@ export default function AppShell() {
         isNewUser: currentUser.isNewUser,
         userId: currentUser.id,
       }}
-      tourFacts={{
-        features: currentUser.enabledFeatures,
-      }}
     >
       <App />
       <ModelNexChatBubble appName="My Product" />
@@ -44,7 +41,7 @@ export default function AppShell() {
 }
 ```
 
-`websiteId` identifies the integration. `userProfile` is used for tour/onboarding targeting and completion tracking. `tourFacts.features` is used for `feature_unlocked` experiences.
+`websiteId` identifies the integration. `userProfile` is used for tour/workflow targeting and completion tracking.
 
 ## Tour Start Model
 
@@ -54,7 +51,7 @@ ModelNex currently supports these automatic trigger types:
 - `feature_unlocked`
 - `manual`
 
-Each tour or onboarding flow can also configure:
+Each tour or workflow can also configure:
 
 - `startPolicy`: `immediate_start` | `prompt_only` | `manual_only`
 - `notificationType`: `bubble_card` | `modal`
@@ -70,12 +67,11 @@ Current behavior:
 
 | Export | Purpose |
 |--------|---------|
-| `ModelNexProvider` | Root provider for server connection, chat state, dev tools, tours, and onboarding |
-| `ModelNexChatBubble` | Unified assistant UI for chat, voice tours, and guided onboarding |
+| `ModelNexProvider` | Root provider for server connection, chat state, dev tools, tours, and workflows |
+| `ModelNexChatBubble` | Unified assistant UI for chat, voice tours, and workflows |
 | `useRunCommand` | Run agent commands from custom UI |
-| `useRegisterAction` | Register app actions the agent can execute |
 | `useTourPlayback` | Low-level playback hook for tours and shared experience runtime |
-| `useOnboardingPlayback` | Playback hook preconfigured for onboarding flows |
+| `useOnboardingPlayback` | Playback hook preconfigured for workflow playback |
 | `useExperiencePlayback` | Alias over the shared playback hook |
 | `useRecordingMode` | Low-level recorder hook for custom authoring UI |
 | `useActionHighlight` | Highlight actions currently being executed |
@@ -86,12 +82,8 @@ Current behavior:
 
 | Prop | Purpose |
 |------|---------|
-| `serverUrl` | ModelNex server base URL. Defaults to `https://api.modelnex.io` |
-| `commandUrl` | Optional same-origin command proxy base |
 | `websiteId` | Tenant/integration identifier |
-| `userProfile` | End-user targeting data for tours/onboarding |
-| `tourFacts` | Additional facts, currently used for feature-based eligibility |
-| `toursApiBase` | Same-origin API base for tour/onboarding fetches and test URLs |
+| `userProfile` | End-user targeting data for tours/workflows |
 | `devMode` | Enables recording/studio tooling for your internal users |
 
 ## Chat Bubble Props
@@ -102,15 +94,79 @@ Current behavior:
 | `defaultCommand` | Fallback command when the input is empty |
 | `welcomeMessage` | Empty-state greeting |
 | `appName` | Product name used in narration and UI copy |
+| `agentName` | Name of the AI agent displayed in the header |
 | `onCommand` | Custom backend override for agent command handling |
 | `recordingExperienceType` | Save recordings as `'tour'` or `'onboarding'` |
 | `className` | Additional class name for the container |
+| `theme` | Custom theme overrides for the chat bubble and panel (`accentColor`, `panelWidth`, etc.) |
+
+## Configuration Examples
+
+Here are some real-world examples of how to configure the SDK.
+
+### Fully Customized Provider
+
+```tsx
+import { ModelNexProvider } from '@modelnex/sdk';
+
+export function AppShell({ children, currentUser }) {
+  return (
+    <ModelNexProvider
+      websiteId="prod_site_123"
+      
+      // Development setup
+      devMode={process.env.NODE_ENV === 'development'}
+      
+      // User Targeting for Tours & Workflows
+      userProfile={{
+        userId: currentUser.id,
+        isNewUser: currentUser.createdAt > Date.now() - 86400000 * 7, // 7 days
+        type: currentUser.role, // e.g. "admin", "viewer"
+      }}
+    >
+      {children}
+    </ModelNexProvider>
+  );
+}
+```
+
+### Themed Chat Bubble
+
+```tsx
+import { ModelNexChatBubble } from '@modelnex/sdk';
+
+export function ChatIntegration() {
+  return (
+    <ModelNexChatBubble 
+      // Branding & Copy
+      appName="Acme Corp Dashboard"
+      agentName="Acme Assistant"
+      welcomeMessage="Hi there! Ask me to navigate to a page or help you with your account."
+      placeholder="Type a command or ask a question..."
+      defaultCommand="Show me my recent activity"
+      
+      // Recording defaults
+      recordingExperienceType="onboarding" // Default is 'tour'
+      
+      // Visual Theme Customization
+      theme={{
+        accentColor: "#f59e0b", // Amber accent
+        accentForeground: "#ffffff",
+        panelWidth: "400px", // Wider panel
+        panelMaxHeight: "700px",
+        bubbleSize: "64px", // Larger bubble
+        borderRadius: "24px",
+        zIndex: 9999
+      }}
+    />
+  );
+}
+```
 
 ## Testing Flows
 
 - Force a tour with `?modelnex_test_tour=TOUR_ID`
-- Force onboarding with `?modelnex_test_onboarding=FLOW_ID`
-- If you use a same-origin proxy, set `toursApiBase` so test fetches avoid CORS issues
+- Force a workflow with `?modelnex_test_workflow=FLOW_ID`
 
 ## Custom UI
 

package/dist/index.d.mts

@@ -1,5 +1,4 @@
 import React$1 from 'react';
-import { z } from 'zod';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 type ExperienceType = 'tour' | 'onboarding';
@@ -204,10 +203,6 @@ interface UserProfile {
     /** User ID for per-user completion state */
     userId?: string;
 }
-interface TourFacts {
-    /** Feature keys currently available to the user, used for feature_unlocked tours */
-    features?: string[];
-}
 /** Playback state machine states */
 type TourPlaybackState = 'idle' | 'intro' | 'executing' | 'thinking' | 'waiting_voice' | 'waiting_input' | 'paused' | 'complete';
 /** Internal recording step being built */
@@ -402,22 +397,6 @@ interface ChatMessage {
     debug?: AgentDebug;
 }
 
-interface UseRegisterActionOptions<T extends z.ZodTypeAny = z.ZodTypeAny> {
-    id: string;
-    description: string;
-    schema: T;
-    execute: (params: z.infer<T>) => unknown | Promise<unknown>;
-}
-/**
- * Register a custom action with the ModelNex agent.
- * Use this to add app-specific actions (e.g. navigation, domain operations).
- * The action is synced to the server with built-in actions and can be invoked by the agent.
- *
- * Must be used within ModelNexProvider.
- * Memoize schema (define outside component) and execute (useCallback) to avoid unnecessary re-registration.
- */
-declare function useRegisterAction<T extends z.ZodTypeAny = z.ZodTypeAny>(action: UseRegisterActionOptions<T>): void;
-
 interface UIStateProviderProps {
     children: React$1.ReactNode;
     /** Agent context id (default: "agent-ui-state") */
@@ -471,22 +450,12 @@ interface ModelNexChatBubbleProps {
     defaultCommand?: string;
     /** Additional class names for the container */
     className?: string;
-    /** Custom fetch - use your own inference/backend. Omit to use agent server from Provider. */
-    onCommand?: (command: string) => Promise<{
-        actionsExecuted?: number;
-        summary?: string;
-        nextSteps?: string[];
-        debug?: AgentDebug;
-        [key: string]: unknown;
-    }>;
     /** Welcome message when chat is empty */
     welcomeMessage?: string;
     /** Name of the AI agent displayed in the header */
     agentName?: string;
     /** Display name of the app — used in tour intro narration */
     appName?: string;
-    /** Save recorded flows as tours or onboarding without changing the recorder UX */
-    recordingExperienceType?: ExperienceType;
     /** Custom theme overrides */
     theme?: {
         accentColor?: string;
@@ -504,7 +473,7 @@ interface ModelNexChatBubbleProps {
  * Shows conversation history; on exit, the agent summarizes what it did and suggests next steps.
  * Use within ModelNexProvider. Omit to use your own UI with useRunCommand.
  */
-declare function ModelNexChatBubble({ placeholder, defaultCommand, className, onCommand, welcomeMessage, agentName, appName, recordingExperienceType, theme, }: ModelNexChatBubbleProps): React$1.ReactPortal | null;
+declare function ModelNexChatBubble({ placeholder, defaultCommand, className, welcomeMessage, agentName, appName, theme, }: ModelNexChatBubbleProps): React$1.ReactPortal | null;
 
 interface ModelNexOnboardingPanelProps {
     appName?: string;
@@ -678,7 +647,6 @@ interface UseTourPlaybackOptions {
     socketId?: string | null;
     websiteId?: string;
     userProfile?: UserProfile;
-    tourFacts?: TourFacts;
     voice: VoiceHook;
     appName?: string;
     /** Pass the page's current state to the LLM agent */
@@ -698,7 +666,7 @@ interface UseTourPlaybackOptions {
     /** Disable internal pending prompt/query discovery when a higher-level controller owns it */
     enableAutoDiscovery?: boolean;
 }
-declare function useTourPlayback({ serverUrl, commandUrl, toursApiBase, socketId, websiteId, userProfile, tourFacts, voice, appName, extractedElements, tagStore, onStepChange, onTourEnd, disabled, experienceType, showCaptions, enableAutoDiscovery, }: UseTourPlaybackOptions): TourPlaybackHook;
+declare function useTourPlayback({ serverUrl, commandUrl, toursApiBase, socketId, websiteId, userProfile, voice, appName, extractedElements, tagStore, onStepChange, onTourEnd, disabled, experienceType, showCaptions, enableAutoDiscovery, }: UseTourPlaybackOptions): TourPlaybackHook;
 
 type ExperiencePlaybackHook = TourPlaybackHook;
 declare function useExperiencePlayback(...args: Parameters<typeof useTourPlayback>): TourPlaybackHook;
@@ -840,7 +808,7 @@ interface SavedDraftPreview {
     experienceType: ExperienceType;
 }
 type PreviewLaunchSource = 'standard' | 'query_param';
-declare function getPreviewQueryParamName(experienceType: ExperienceType): 'modelnex_test_tour' | 'modelnex_test_onboarding';
+declare function getPreviewQueryParamName(experienceType: ExperienceType): 'modelnex_test_tour' | 'modelnex_test_workflow';
 declare function buildDraftPreviewUrl(currentUrl: string, draft: SavedDraftPreview): string;
 declare function shouldPromptForPreviewStart(notificationType: TourNotificationType | undefined, _source: PreviewLaunchSource): boolean;
 declare function persistActiveDraftPreview(draft: SavedDraftPreview): void;
@@ -849,11 +817,6 @@ declare function clearActiveDraftPreview(experienceType?: ExperienceType): void;
 
 interface ModelNexProviderProps {
     children?: unknown;
-    serverUrl?: string;
-    /** Base URL for agent commands. Use same-origin path (e.g. /api/modelnex) to avoid CORS. Default: serverUrl */
-    commandUrl?: string;
-    /** Disable the realtime socket connection while still rendering the SDK UI */
-    disableSocket?: boolean;
     /** Identifier for the integrated website, for multi-tenancy */
     websiteId?: string;
     /**
@@ -863,13 +826,6 @@ interface ModelNexProviderProps {
      * userId — used for per-user tour completion state
      */
     userProfile?: UserProfile;
-    /** Optional product facts used for feature-triggered tours */
-    tourFacts?: TourFacts;
-    /**
-     * Same-origin base for tour API (e.g. /api/modelnex/api).
-     * When set, ?modelnex_test_tour= fetches via this path to avoid CORS.
-     */
-    toursApiBase?: string;
     /**
      * Enable SDK dev tools unconditionally (tour recording, studio mode)
      */
@@ -877,4 +833,4 @@ interface ModelNexProviderProps {
 }
 declare const ModelNexProvider: React$1.FC<ModelNexProviderProps>;
 
-export { type AgentDebug, type AgentTraceLlmInput, type AgentTraceStep, type ChatMessage, type ExperienceGoal, type ExperiencePlaybackHook, type ExperiencePresentation, type ExperienceType, type ExtractedElement, ModelNexChatBubble, type ModelNexChatBubbleProps, ModelNexOnboardingPanel, type ModelNexOnboardingPanelProps, ModelNexProvider, type ModelNexProviderProps, type OnboardingPlaybackHook, type OnboardingStepMetadata, type PreviewLaunchSource, type RecordingModeHook, RecordingOverlay, type RunCommandResult, type SavedDraftPreview, StudioOverlay, type TagData, type TagStore, type Tour, type TourFacts, type TourNotificationType, type TourPlaybackHook, type TourPlaybackState, TourProgressPanel, type TourStartPolicy, type TourStep, type TourStepType, type TourTrigger, UIStateProvider, type UseRegisterActionOptions, type UserProfile, type VoiceHook, buildDraftPreviewUrl, buildRecordingCapturePayload, buildRecordingStepGoal, clearActiveDraftPreview, extractInteractiveElements, generateFingerprint, getPreviewQueryParamName, getRecordingDraftActionLabel, getRecordingDraftStatusMessage, inferOnboardingMetadataForStep, isAskDrivenInputStepType, isInteractiveInputStepType, isManualOnboardingStep, isRecordingDraftGenerating, persistActiveDraftPreview, readActiveDraftPreview, shouldPromptForPreviewStart, shouldShowRecordingOverlay, useActionHighlight, useAgentViewport, useAutoExtract, useExperiencePlayback, useOnboardingPlayback, useRecordingMode, useRegisterAction, useRunCommand, useTagStore, useTourPlayback, useUIState, useViewportTrack, useVisibleIds, useVoice };
+export { type AgentDebug, type AgentTraceLlmInput, type AgentTraceStep, type ChatMessage, type ExperienceGoal, type ExperiencePlaybackHook, type ExperiencePresentation, type ExperienceType, type ExtractedElement, ModelNexChatBubble, type ModelNexChatBubbleProps, ModelNexOnboardingPanel, type ModelNexOnboardingPanelProps, ModelNexProvider, type ModelNexProviderProps, type OnboardingPlaybackHook, type OnboardingStepMetadata, type PreviewLaunchSource, type RecordingModeHook, RecordingOverlay, type RunCommandResult, type SavedDraftPreview, StudioOverlay, type TagData, type TagStore, type Tour, type TourNotificationType, type TourPlaybackHook, type TourPlaybackState, TourProgressPanel, type TourStartPolicy, type TourStep, type TourStepType, type TourTrigger, UIStateProvider, type UserProfile, type VoiceHook, buildDraftPreviewUrl, buildRecordingCapturePayload, buildRecordingStepGoal, clearActiveDraftPreview, extractInteractiveElements, generateFingerprint, getPreviewQueryParamName, getRecordingDraftActionLabel, getRecordingDraftStatusMessage, inferOnboardingMetadataForStep, isAskDrivenInputStepType, isInteractiveInputStepType, isManualOnboardingStep, isRecordingDraftGenerating, persistActiveDraftPreview, readActiveDraftPreview, shouldPromptForPreviewStart, shouldShowRecordingOverlay, useActionHighlight, useAgentViewport, useAutoExtract, useExperiencePlayback, useOnboardingPlayback, useRecordingMode, useRunCommand, useTagStore, useTourPlayback, useUIState, useViewportTrack, useVisibleIds, useVoice };

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 import React$1 from 'react';
-import { z } from 'zod';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 type ExperienceType = 'tour' | 'onboarding';
@@ -204,10 +203,6 @@ interface UserProfile {
     /** User ID for per-user completion state */
     userId?: string;
 }
-interface TourFacts {
-    /** Feature keys currently available to the user, used for feature_unlocked tours */
-    features?: string[];
-}
 /** Playback state machine states */
 type TourPlaybackState = 'idle' | 'intro' | 'executing' | 'thinking' | 'waiting_voice' | 'waiting_input' | 'paused' | 'complete';
 /** Internal recording step being built */
@@ -402,22 +397,6 @@ interface ChatMessage {
     debug?: AgentDebug;
 }
 
-interface UseRegisterActionOptions<T extends z.ZodTypeAny = z.ZodTypeAny> {
-    id: string;
-    description: string;
-    schema: T;
-    execute: (params: z.infer<T>) => unknown | Promise<unknown>;
-}
-/**
- * Register a custom action with the ModelNex agent.
- * Use this to add app-specific actions (e.g. navigation, domain operations).
- * The action is synced to the server with built-in actions and can be invoked by the agent.
- *
- * Must be used within ModelNexProvider.
- * Memoize schema (define outside component) and execute (useCallback) to avoid unnecessary re-registration.
- */
-declare function useRegisterAction<T extends z.ZodTypeAny = z.ZodTypeAny>(action: UseRegisterActionOptions<T>): void;
-
 interface UIStateProviderProps {
     children: React$1.ReactNode;
     /** Agent context id (default: "agent-ui-state") */
@@ -471,22 +450,12 @@ interface ModelNexChatBubbleProps {
     defaultCommand?: string;
     /** Additional class names for the container */
     className?: string;
-    /** Custom fetch - use your own inference/backend. Omit to use agent server from Provider. */
-    onCommand?: (command: string) => Promise<{
-        actionsExecuted?: number;
-        summary?: string;
-        nextSteps?: string[];
-        debug?: AgentDebug;
-        [key: string]: unknown;
-    }>;
     /** Welcome message when chat is empty */
     welcomeMessage?: string;
     /** Name of the AI agent displayed in the header */
     agentName?: string;
     /** Display name of the app — used in tour intro narration */
     appName?: string;
-    /** Save recorded flows as tours or onboarding without changing the recorder UX */
-    recordingExperienceType?: ExperienceType;
     /** Custom theme overrides */
     theme?: {
         accentColor?: string;
@@ -504,7 +473,7 @@ interface ModelNexChatBubbleProps {
  * Shows conversation history; on exit, the agent summarizes what it did and suggests next steps.
  * Use within ModelNexProvider. Omit to use your own UI with useRunCommand.
  */
-declare function ModelNexChatBubble({ placeholder, defaultCommand, className, onCommand, welcomeMessage, agentName, appName, recordingExperienceType, theme, }: ModelNexChatBubbleProps): React$1.ReactPortal | null;
+declare function ModelNexChatBubble({ placeholder, defaultCommand, className, welcomeMessage, agentName, appName, theme, }: ModelNexChatBubbleProps): React$1.ReactPortal | null;
 
 interface ModelNexOnboardingPanelProps {
     appName?: string;
@@ -678,7 +647,6 @@ interface UseTourPlaybackOptions {
     socketId?: string | null;
     websiteId?: string;
     userProfile?: UserProfile;
-    tourFacts?: TourFacts;
     voice: VoiceHook;
     appName?: string;
     /** Pass the page's current state to the LLM agent */
@@ -698,7 +666,7 @@ interface UseTourPlaybackOptions {
     /** Disable internal pending prompt/query discovery when a higher-level controller owns it */
     enableAutoDiscovery?: boolean;
 }
-declare function useTourPlayback({ serverUrl, commandUrl, toursApiBase, socketId, websiteId, userProfile, tourFacts, voice, appName, extractedElements, tagStore, onStepChange, onTourEnd, disabled, experienceType, showCaptions, enableAutoDiscovery, }: UseTourPlaybackOptions): TourPlaybackHook;
+declare function useTourPlayback({ serverUrl, commandUrl, toursApiBase, socketId, websiteId, userProfile, voice, appName, extractedElements, tagStore, onStepChange, onTourEnd, disabled, experienceType, showCaptions, enableAutoDiscovery, }: UseTourPlaybackOptions): TourPlaybackHook;
 
 type ExperiencePlaybackHook = TourPlaybackHook;
 declare function useExperiencePlayback(...args: Parameters<typeof useTourPlayback>): TourPlaybackHook;
@@ -840,7 +808,7 @@ interface SavedDraftPreview {
     experienceType: ExperienceType;
 }
 type PreviewLaunchSource = 'standard' | 'query_param';
-declare function getPreviewQueryParamName(experienceType: ExperienceType): 'modelnex_test_tour' | 'modelnex_test_onboarding';
+declare function getPreviewQueryParamName(experienceType: ExperienceType): 'modelnex_test_tour' | 'modelnex_test_workflow';
 declare function buildDraftPreviewUrl(currentUrl: string, draft: SavedDraftPreview): string;
 declare function shouldPromptForPreviewStart(notificationType: TourNotificationType | undefined, _source: PreviewLaunchSource): boolean;
 declare function persistActiveDraftPreview(draft: SavedDraftPreview): void;
@@ -849,11 +817,6 @@ declare function clearActiveDraftPreview(experienceType?: ExperienceType): void;
 
 interface ModelNexProviderProps {
     children?: unknown;
-    serverUrl?: string;
-    /** Base URL for agent commands. Use same-origin path (e.g. /api/modelnex) to avoid CORS. Default: serverUrl */
-    commandUrl?: string;
-    /** Disable the realtime socket connection while still rendering the SDK UI */
-    disableSocket?: boolean;
     /** Identifier for the integrated website, for multi-tenancy */
     websiteId?: string;
     /**
@@ -863,13 +826,6 @@ interface ModelNexProviderProps {
      * userId — used for per-user tour completion state
      */
     userProfile?: UserProfile;
-    /** Optional product facts used for feature-triggered tours */
-    tourFacts?: TourFacts;
-    /**
-     * Same-origin base for tour API (e.g. /api/modelnex/api).
-     * When set, ?modelnex_test_tour= fetches via this path to avoid CORS.
-     */
-    toursApiBase?: string;
     /**
      * Enable SDK dev tools unconditionally (tour recording, studio mode)
      */
@@ -877,4 +833,4 @@ interface ModelNexProviderProps {
 }
 declare const ModelNexProvider: React$1.FC<ModelNexProviderProps>;
 
-export { type AgentDebug, type AgentTraceLlmInput, type AgentTraceStep, type ChatMessage, type ExperienceGoal, type ExperiencePlaybackHook, type ExperiencePresentation, type ExperienceType, type ExtractedElement, ModelNexChatBubble, type ModelNexChatBubbleProps, ModelNexOnboardingPanel, type ModelNexOnboardingPanelProps, ModelNexProvider, type ModelNexProviderProps, type OnboardingPlaybackHook, type OnboardingStepMetadata, type PreviewLaunchSource, type RecordingModeHook, RecordingOverlay, type RunCommandResult, type SavedDraftPreview, StudioOverlay, type TagData, type TagStore, type Tour, type TourFacts, type TourNotificationType, type TourPlaybackHook, type TourPlaybackState, TourProgressPanel, type TourStartPolicy, type TourStep, type TourStepType, type TourTrigger, UIStateProvider, type UseRegisterActionOptions, type UserProfile, type VoiceHook, buildDraftPreviewUrl, buildRecordingCapturePayload, buildRecordingStepGoal, clearActiveDraftPreview, extractInteractiveElements, generateFingerprint, getPreviewQueryParamName, getRecordingDraftActionLabel, getRecordingDraftStatusMessage, inferOnboardingMetadataForStep, isAskDrivenInputStepType, isInteractiveInputStepType, isManualOnboardingStep, isRecordingDraftGenerating, persistActiveDraftPreview, readActiveDraftPreview, shouldPromptForPreviewStart, shouldShowRecordingOverlay, useActionHighlight, useAgentViewport, useAutoExtract, useExperiencePlayback, useOnboardingPlayback, useRecordingMode, useRegisterAction, useRunCommand, useTagStore, useTourPlayback, useUIState, useViewportTrack, useVisibleIds, useVoice };
+export { type AgentDebug, type AgentTraceLlmInput, type AgentTraceStep, type ChatMessage, type ExperienceGoal, type ExperiencePlaybackHook, type ExperiencePresentation, type ExperienceType, type ExtractedElement, ModelNexChatBubble, type ModelNexChatBubbleProps, ModelNexOnboardingPanel, type ModelNexOnboardingPanelProps, ModelNexProvider, type ModelNexProviderProps, type OnboardingPlaybackHook, type OnboardingStepMetadata, type PreviewLaunchSource, type RecordingModeHook, RecordingOverlay, type RunCommandResult, type SavedDraftPreview, StudioOverlay, type TagData, type TagStore, type Tour, type TourNotificationType, type TourPlaybackHook, type TourPlaybackState, TourProgressPanel, type TourStartPolicy, type TourStep, type TourStepType, type TourTrigger, UIStateProvider, type UserProfile, type VoiceHook, buildDraftPreviewUrl, buildRecordingCapturePayload, buildRecordingStepGoal, clearActiveDraftPreview, extractInteractiveElements, generateFingerprint, getPreviewQueryParamName, getRecordingDraftActionLabel, getRecordingDraftStatusMessage, inferOnboardingMetadataForStep, isAskDrivenInputStepType, isInteractiveInputStepType, isManualOnboardingStep, isRecordingDraftGenerating, persistActiveDraftPreview, readActiveDraftPreview, shouldPromptForPreviewStart, shouldShowRecordingOverlay, useActionHighlight, useAgentViewport, useAutoExtract, useExperiencePlayback, useOnboardingPlayback, useRecordingMode, useRunCommand, useTagStore, useTourPlayback, useUIState, useViewportTrack, useVisibleIds, useVoice };