@gengage/assistant-fe 0.3.18 → 0.3.20

package/dist/chat/api.d.ts

@@ -17,6 +17,7 @@ export interface BackendRequestMeta {
     isControlGroup: boolean;
     isMobile: boolean;
     viewId?: string;
+    assistantMode?: string;
 }
 export interface ProcessActionRequest {
     account_id: string;
@@ -75,6 +76,8 @@ export interface StreamCallbacks {
         }> | undefined;
         skuToProductItem?: Record<string, Record<string, unknown>> | undefined;
         conversationMode?: string | undefined;
+        renderHint?: string | undefined;
+        kvkk?: boolean | undefined;
     }) => void;
     onUISpec: (spec: UISpec, widget: string, panelHint?: 'panel', clearPanel?: boolean) => void;
     onAction: (event: StreamEvent) => void;
@@ -83,4 +86,3 @@ export interface StreamCallbacks {
     onDone: () => void;
 }
 export declare function sendChatMessage(request: ProcessActionRequest, callbacks: StreamCallbacks, transport: ChatTransportConfig): AbortController;
-//# sourceMappingURL=api.d.ts.map

package/dist/chat/assistant-mode.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Assistant-mode utilities for the chat widget.
+ *
+ * The chat widget can operate in multiple modes (shopping, beauty consulting,
+ * watch expert, booking). This module contains the type, parsing helpers, and
+ * recognised mode list so the main index.ts stays focused on orchestration.
+ */
+export type AssistantMode = 'shopping' | 'booking' | 'beauty_consulting' | 'watch_expert';
+/** Return the value as an AssistantMode if it is a known mode string, otherwise null. */
+export declare function toAssistantMode(value: unknown): AssistantMode | null;
+/** Safely cast an unknown value to a plain Record, or null. */
+export declare function asRecord(value: unknown): Record<string, unknown> | null;
+/** Return the first non-empty string among the given values. */
+export declare function firstString(...values: unknown[]): string | undefined;
+/**
+ * Parse a redirect metadata payload and return the target assistant mode,
+ * or `null` if the payload is not a valid mode-switch redirect.
+ */
+export declare function parseRedirectMode(redirectPayload: unknown): AssistantMode | null;

package/dist/chat/attachment-utils.d.ts

@@ -7,4 +7,3 @@ export type ValidationResult = {
     reason: 'invalid_type' | 'too_large';
 };
 export declare function validateImageFile(file: File): ValidationResult;
-//# sourceMappingURL=attachment-utils.d.ts.map

package/dist/chat/catalog.d.ts

@@ -359,6 +359,19 @@ export declare const HandoffNoticeSchema: z.ZodObject<{
     products_discussed: z.ZodOptional<z.ZodArray<z.ZodString>>;
     user_sentiment: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+export declare const PhotoAnalysisCardSchema: z.ZodObject<{
+    summary: z.ZodString;
+    clues: z.ZodArray<z.ZodString>;
+    next_question: z.ZodOptional<z.ZodString>;
+    style_images: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const BeautyPhotoStepSchema: z.ZodObject<{
+    processing: z.ZodOptional<z.ZodBoolean>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    upload_label: z.ZodOptional<z.ZodString>;
+    skip_label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const chatCatalog: {
     readonly components: {
         readonly MessageBubble: {
@@ -741,8 +754,26 @@ export declare const chatCatalog: {
             }, z.core.$strip>;
             readonly description: "A notice shown when the conversation is escalated to a human agent.";
         };
+        readonly PhotoAnalysisCard: {
+            readonly schema: z.ZodObject<{
+                summary: z.ZodString;
+                clues: z.ZodArray<z.ZodString>;
+                next_question: z.ZodOptional<z.ZodString>;
+                style_images: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>;
+            readonly description: "Structured photo analysis card with summary, clues, and follow-up question.";
+        };
+        readonly BeautyPhotoStep: {
+            readonly schema: z.ZodObject<{
+                processing: z.ZodOptional<z.ZodBoolean>;
+                title: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+                upload_label: z.ZodOptional<z.ZodString>;
+                skip_label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            readonly description: "Transient selfie upload prompt for beauty consulting init flow.";
+        };
     };
 };
 export type ChatCatalog = typeof chatCatalog;
 export type ChatComponentName = keyof ChatCatalog['components'];
-//# sourceMappingURL=catalog.d.ts.map

package/dist/chat/chat-presentation-state.d.ts

@@ -51,4 +51,3 @@ export declare class ChatPresentationState {
  * Latest assistant “group” with unread semantics (for auto-anchor).
  */
 export declare function getLatestUnreadAssistantThreadId(orderedThreadIds: string[], state: ChatPresentationState): string | null;
-//# sourceMappingURL=chat-presentation-state.d.ts.map

package/dist/chat/components/AIGroupingCards.d.ts

@@ -1,4 +1,3 @@
 import { UIElement } from '../../common/types.js';
 import { ChatUISpecRenderContext } from '../types.js';
 export declare function renderAIGroupingCards(element: UIElement, ctx: ChatUISpecRenderContext): HTMLElement;
-//# sourceMappingURL=AIGroupingCards.d.ts.map

package/dist/chat/components/AISuggestedSearchCards.d.ts

@@ -1,4 +1,3 @@
 import { UIElement } from '../../common/types.js';
 import { ChatUISpecRenderContext } from '../types.js';
 export declare function renderAISuggestedSearchCards(element: UIElement, ctx: ChatUISpecRenderContext): HTMLElement;
-//# sourceMappingURL=AISuggestedSearchCards.d.ts.map

package/dist/chat/components/AITopPicks.d.ts

@@ -1,4 +1,3 @@
 import { UIElement } from '../../common/types.js';
 import { ChatUISpecRenderContext } from '../types.js';
 export declare function renderAITopPicks(element: UIElement, ctx: ChatUISpecRenderContext): HTMLElement;
-//# sourceMappingURL=AITopPicks.d.ts.map

package/dist/chat/components/BeautyPhotoStep.d.ts

@@ -0,0 +1,16 @@
+import { UIElement } from '../../common/types.js';
+import { ChatUISpecRenderContext } from '../types.js';
+export interface BeautyPhotoStepProps {
+    processing: boolean;
+    title?: string | undefined;
+    description?: string | undefined;
+    uploadLabel?: string | undefined;
+    skipLabel?: string | undefined;
+}
+/** Extract typed props from a raw UISpec element props bag. */
+export declare function parseBeautyPhotoStepProps(props: Record<string, unknown>): BeautyPhotoStepProps;
+export interface BeautyPhotoStepCallbacks {
+    onUpload?: (() => void) | undefined;
+    onSkip?: (() => void) | undefined;
+}
+export declare function renderBeautyPhotoStep(element: UIElement, ctx: ChatUISpecRenderContext, callbacks?: BeautyPhotoStepCallbacks): HTMLElement;

package/dist/chat/components/CategoriesContainer.d.ts

@@ -1,4 +1,3 @@
 import { UIElement } from '../../common/types.js';
 import { ChatUISpecRenderContext } from '../types.js';
 export declare function renderCategoriesContainer(element: UIElement, context: ChatUISpecRenderContext): HTMLElement;
-//# sourceMappingURL=CategoriesContainer.d.ts.map

package/dist/chat/components/ChatDrawer.d.ts

@@ -141,6 +141,8 @@ export declare class ChatDrawer {
     private _typingLoadingBinding;
     private _panelLoadingBinding;
     private _panelAiZoneLoadingBinding;
+    private _beautyPhotoStepEl;
+    private _renderPhotoAnalysisCard;
     constructor(container: HTMLElement, options: ChatDrawerOptions);
     addMessage(message: ChatMessage): void;
     /** Remove one transcript bubble (e.g. superseded empty assistant placeholder). */
@@ -181,6 +183,20 @@ export declare class ChatDrawer {
     /** True when the KVKK banner is mounted (user has not dismissed it yet). */
     isKvkkBannerVisible(): boolean;
     getElement(): HTMLElement;
+    /** Opens the hidden file picker used by the attachment flow. */
+    openAttachmentPicker(): void;
+    /** Show/hide camera attach controls in the input shell. */
+    setAttachmentControlsVisible(visible: boolean): void;
+    /** Beauty mode selfie helper card shown above the input area. */
+    setBeautyPhotoStepCard(options: {
+        visible: boolean;
+        processing?: boolean;
+        onSkip?: (() => void) | undefined;
+        title?: string | undefined;
+        description?: string | undefined;
+        uploadLabel?: string | undefined;
+        skipLabel?: string | undefined;
+    }): void;
     /** Stage a file attachment for sending. Shows preview. */
     stageAttachment(file: File): void;
     /** Remove the staged attachment and hide preview. */
@@ -284,7 +300,11 @@ export declare class ChatDrawer {
     /** Public method for typewriter ticks — scrolls only if user is near bottom. */
     scrollToBottomIfNeeded(): void;
     /** Update a bot message's text content in the DOM (e.g. for fallback messages). */
-    updateBotMessage(messageId: string, html: string): void;
+    updateBotMessage(messageId: string, html: string, renderHint?: string, photoAnalysis?: {
+        summary: string;
+        clues: string[];
+        nextQuestion?: string;
+    }): void;
     /** Mark a message as the first bot message in its thread (for special styling). */
     markFirstBotMessage(messageId: string): void;
     /** Scroll to the first message of the last thread (for restore targeting). */
@@ -300,6 +320,7 @@ export declare class ChatDrawer {
     /** Collapse transcript to a single thread (null = show full history). */
     setPresentationFocus(threadId: string | null): void;
     setFormerMessagesButtonVisible(visible: boolean): void;
+    setInputPlaceholder(placeholder: string): void;
     private _applyPresentationCollapsed;
     /** Call after inline chat DOM (e.g. ProductSummaryCard) is appended — reapplies thread collapse. */
     refreshPresentationCollapsed(): void;
@@ -326,4 +347,3 @@ export declare class ChatDrawer {
     /** Clean up event listeners and child resources (VoiceInput, timers). */
     destroy(): void;
 }
-//# sourceMappingURL=ChatDrawer.d.ts.map

package/dist/chat/components/ChoicePrompter.d.ts

@@ -19,4 +19,3 @@ export declare function clearChoicePrompterDismissState(): void;
 export declare function isChoicePrompterDismissed(threadId: string): boolean;
 /** Toolbar “Karşılaştır” gibi dış aksiyonlarda CTA ile aynı dismiss kaydı. */
 export declare function recordChoicePrompterDismissedForThread(threadId: string): void;
-//# sourceMappingURL=ChoicePrompter.d.ts.map

package/dist/chat/components/ComparisonTable.d.ts

@@ -54,4 +54,3 @@ export interface ComparisonTableOptions {
     pricing?: PriceFormatConfig | undefined;
 }
 export declare function renderComparisonTable(options: ComparisonTableOptions): HTMLElement;
-//# sourceMappingURL=ComparisonTable.d.ts.map

package/dist/chat/components/ConsultingStylePicker.d.ts

@@ -0,0 +1,25 @@
+import { ChatUISpecRenderContext } from '../types.js';
+export type StyleVariationProduct = Record<string, unknown>;
+export type StyleVariation = {
+    style_label?: string;
+    style_mood?: string;
+    image_url?: string;
+    product_list?: StyleVariationProduct[];
+    recommendation_groups?: Array<{
+        label?: string;
+        reason?: string;
+        skus?: string[];
+    }>;
+};
+/** Normalise a consulting image URL from the backend (absolute or relative). */
+export declare function toConsultingImageUrl(input: unknown): string | undefined;
+/**
+ * Renders the consulting style picker UI (variation buttons + grouped product grid).
+ *
+ * @param wrapper   Container to append into.
+ * @param grid      The product grid element (cleared and repopulated per variation).
+ * @param source    Backend source tag (`beauty_consulting` | `watch_expert`).
+ * @param styleVariations  Non-empty filtered variation list.
+ * @param ctx       Render context (i18n, callbacks).
+ */
+export declare function renderConsultingStylePicker(wrapper: HTMLElement, grid: HTMLElement, source: string, styleVariations: StyleVariation[], ctx?: ChatUISpecRenderContext): void;

package/dist/chat/components/FloatingComparisonButton.d.ts

@@ -1,3 +1,2 @@
 import { ChatUISpecRenderContext } from '../types.js';
 export declare function renderFloatingComparisonButton(selectedSkus: string[], ctx: ChatUISpecRenderContext): HTMLElement;
-//# sourceMappingURL=FloatingComparisonButton.d.ts.map

package/dist/chat/components/GroundingReviewCard.d.ts

@@ -1,4 +1,3 @@
 import { UIElement } from '../../common/types.js';
 import { ChatUISpecRenderContext } from '../types.js';
 export declare function renderGroundingReviewCard(element: UIElement, ctx: ChatUISpecRenderContext): HTMLElement;
-//# sourceMappingURL=GroundingReviewCard.d.ts.map

package/dist/chat/components/HandoffNotice.d.ts

@@ -2,4 +2,3 @@ import { ChatUISpecRenderContext } from '../types.js';
 export declare function renderHandoffNotice(element: {
     props?: Record<string, unknown>;
 }, context: ChatUISpecRenderContext): HTMLElement;
-//# sourceMappingURL=HandoffNotice.d.ts.map

package/dist/chat/components/KvkkBanner.d.ts

@@ -4,4 +4,3 @@ export interface KvkkBannerOptions {
     closeAriaLabel?: string;
 }
 export declare function createKvkkBanner(options: KvkkBannerOptions): HTMLElement;
-//# sourceMappingURL=KvkkBanner.d.ts.map

package/dist/chat/components/Launcher.d.ts

@@ -24,4 +24,3 @@ export interface LauncherElements {
     contentAreaBottom: HTMLElement;
 }
 export declare function createLauncher(options: LauncherOptions): LauncherElements;
-//# sourceMappingURL=Launcher.d.ts.map

package/dist/chat/components/PanelTopBar.d.ts

@@ -30,4 +30,3 @@ export declare class PanelTopBar {
     setActions(actionsEl: HTMLElement | null): void;
     getTitle(): string;
 }
-//# sourceMappingURL=PanelTopBar.d.ts.map

package/dist/chat/components/PhotoAnalysisCard.d.ts

@@ -0,0 +1,22 @@
+import { UIElement } from '../../common/types.js';
+import { ChatUISpecRenderContext } from '../types.js';
+export interface PhotoAnalysisData {
+    summary: string;
+    clues: string[];
+    nextQuestion?: string;
+}
+/** Extract structured photo-analysis data from a UISpec element's props. */
+export declare function parsePhotoAnalysisProps(props: Record<string, unknown>): PhotoAnalysisData | null;
+export declare function renderPhotoAnalysisCard(element: UIElement, ctx: ChatUISpecRenderContext): HTMLElement;
+/**
+ * Renders a photo analysis card into a chat message bubble.
+ *
+ * When structured data is available (from a PhotoAnalysisCard UISpec), it renders
+ * the summary, clues, and next question directly. Otherwise, falls back to a
+ * sentence-splitting heuristic for old backends that don't send the UISpec.
+ */
+export declare function renderPhotoAnalysisBubble(container: HTMLElement, content: string, badgeText: string, structured?: {
+    summary: string;
+    clues: string[];
+    nextQuestion?: string;
+}): void;

package/dist/chat/components/ProductSummaryCard.d.ts

@@ -1,4 +1,3 @@
 import { UIElement } from '../../common/types.js';
 import { ChatUISpecRenderContext } from '../types.js';
 export declare function renderProductSummaryCard(element: UIElement, ctx: ChatUISpecRenderContext): HTMLElement;
-//# sourceMappingURL=ProductSummaryCard.d.ts.map

package/dist/chat/components/ProsAndCons.d.ts

@@ -6,4 +6,3 @@
 export declare function renderProsAndCons(element: {
     props?: Record<string, unknown>;
 }): HTMLElement;
-//# sourceMappingURL=ProsAndCons.d.ts.map

package/dist/chat/components/ReviewHighlights.d.ts

@@ -7,4 +7,3 @@ export declare function renderReviewHighlights(element: UIElement, options?: {
     reviewCustomersMentionPlural?: string | undefined;
     reviewSubjectsHeading?: string | undefined;
 }): HTMLElement;
-//# sourceMappingURL=ReviewHighlights.d.ts.map

package/dist/chat/components/ThumbnailsColumn.d.ts

@@ -22,4 +22,3 @@ export declare class ThumbnailsColumn {
     show(): void;
     hide(): void;
 }
-//# sourceMappingURL=ThumbnailsColumn.d.ts.map

package/dist/chat/components/actionClassifier.d.ts

@@ -10,4 +10,3 @@ export declare function isInputAreaAction(btn: {
         type?: string;
     };
 }): boolean;
-//# sourceMappingURL=actionClassifier.d.ts.map

package/dist/chat/components/product-price-layout.d.ts

@@ -16,4 +16,3 @@ export declare function createCampaignPriceBadge(options: {
     salePriceFormatted: string;
     logoUrl?: string;
 }): HTMLElement;
-//# sourceMappingURL=product-price-layout.d.ts.map

package/dist/chat/components/productMentionLinker.d.ts

@@ -23,4 +23,3 @@ export interface ProductMentionLinkerOptions {
  * Only the first occurrence of each mention is linked to avoid visual clutter.
  */
 export declare function linkProductMentions(options: ProductMentionLinkerOptions): void;
-//# sourceMappingURL=productMentionLinker.d.ts.map

package/dist/chat/components/renderUISpec.d.ts

@@ -1,4 +1,4 @@
-import { UISpec } from '../../common/types.js';
+import { UISpec, UIElement } from '../../common/types.js';
 import { UISpecDomRegistry, UISpecDomUnknownRenderer } from '../../common/renderer/index.js';
 import { ChatUISpecRenderContext } from '../types.js';
 import { PriceFormatConfig } from '../../common/price-formatter.js';
@@ -8,4 +8,4 @@ export type { PriceFormatConfig };
 export declare const defaultChatUnknownUISpecRenderer: UISpecDomUnknownRenderer<UISpecRenderContext>;
 export declare function createDefaultChatUISpecRegistry(): ChatUISpecRegistry;
 export declare function renderUISpec(spec: UISpec, ctx: UISpecRenderContext, registry?: ChatUISpecRegistry, unknownRenderer?: UISpecDomUnknownRenderer<UISpecRenderContext>): HTMLElement;
-//# sourceMappingURL=renderUISpec.d.ts.map
+export declare function renderProductCard(element: UIElement, ctx: UISpecRenderContext): HTMLElement;

package/dist/chat/components/typewriter.d.ts

@@ -22,4 +22,3 @@ export interface TypewriterHandle {
     readonly isRunning: boolean;
 }
 export declare function typewriteHtml(options: TypewriterOptions): TypewriterHandle;
-//# sourceMappingURL=typewriter.d.ts.map

package/dist/chat/extendedModeManager.d.ts

@@ -30,4 +30,3 @@ export declare class ExtendedModeManager {
     setPanelContentType(type: PanelContentType | null): void;
     private _checkStateChange;
 }
-//# sourceMappingURL=extendedModeManager.d.ts.map

package/dist/chat/features/beauty-consulting/consulting-grid.d.ts

@@ -0,0 +1,18 @@
+import { UIElement } from '../../../common/types.js';
+import { ChatUISpecRenderContext } from '../../types.js';
+import { StyleVariation } from '../../components/ConsultingStylePicker.js';
+export interface ConsultingGridResult {
+    isConsulting: boolean;
+    source: string | undefined;
+    styleVariations: StyleVariation[];
+}
+/**
+ * Check whether a ProductGrid element should render as a consulting style picker.
+ * Returns the check result plus pre-parsed data for {@link renderConsultingGrid}.
+ */
+export declare function detectConsultingGrid(element: UIElement): ConsultingGridResult;
+/**
+ * Render a consulting style picker into the ProductGrid wrapper.
+ * Call only when `detectConsultingGrid` returned `isConsulting: true`.
+ */
+export declare function renderConsultingGrid(wrapper: HTMLElement, grid: HTMLElement, detected: ConsultingGridResult, ctx?: ChatUISpecRenderContext): void;

package/dist/chat/features/beauty-consulting/drawer-extensions.d.ts

@@ -0,0 +1,20 @@
+import { ChatI18n } from '../../types.js';
+export interface BeautyPhotoStepCardOptions {
+    visible: boolean;
+    processing?: boolean;
+    onSkip?: (() => void) | undefined;
+    title?: string | undefined;
+    description?: string | undefined;
+    uploadLabel?: string | undefined;
+    skipLabel?: string | undefined;
+}
+/**
+ * Lazily create the beauty photo step slot element and insert it before
+ * the input area. Returns the created or existing element.
+ */
+export declare function ensureBeautyPhotoStepSlot(existing: HTMLElement | null, conversationEl: HTMLElement | null): HTMLElement;
+/**
+ * Show or hide the beauty photo step card.
+ * Returns the slot element (possibly newly created).
+ */
+export declare function applyBeautyPhotoStepCard(slotEl: HTMLElement | null, conversationEl: HTMLElement | null, options: BeautyPhotoStepCardOptions, i18n: ChatI18n, openAttachmentPicker: () => void): HTMLElement | null;

package/dist/chat/features/beauty-consulting/mode-controller.d.ts

@@ -0,0 +1,53 @@
+import { AssistantMode } from '../../assistant-mode.js';
+/**
+ * Minimal drawer interface consumed by the mode controller.
+ * Keeps the controller decoupled from ChatDrawer internals.
+ */
+export interface ModeDrawerAdapter {
+    setAttachmentControlsVisible(visible: boolean): void;
+    setInputPlaceholder(text: string): void;
+    setBeautyPhotoStepCard(options: {
+        visible: boolean;
+    }): void;
+}
+export declare class AssistantModeController {
+    private _mode;
+    private _uiHints;
+    get mode(): AssistantMode;
+    set mode(value: AssistantMode);
+    get uiHints(): Record<string, unknown> | null;
+    set uiHints(value: Record<string, unknown> | null);
+    get isShopping(): boolean;
+    get isBeautyConsulting(): boolean;
+    /** Whether choice prompter is hidden by backend ui_hints. */
+    get isChoicePrompterHidden(): boolean;
+    /**
+     * Apply backend ui_hints to the drawer.
+     *
+     * @param drawer  Drawer adapter (null when drawer not yet created).
+     * @param defaultPlaceholder  Default input placeholder for shopping mode.
+     * @param removePersistentChoicePrompter  Callback to remove persistent choice prompter from Shadow DOM.
+     */
+    applyUiHints(drawer: ModeDrawerAdapter | null, defaultPlaceholder: string, removePersistentChoicePrompter?: () => void): void;
+    /**
+     * Handle redirect metadata from a backend metadata event.
+     * Returns true if the mode actually switched.
+     */
+    handleRedirect(redirectPayload: unknown): boolean;
+    /** Switch to a new assistant mode. */
+    switchMode(mode: AssistantMode): void;
+    /**
+     * Derive mode and ui_hints from a backend CONTEXT panel payload.
+     * Missing `assistant_mode` field preserves current mode (old backends).
+     * Explicit `null` resets to shopping.
+     */
+    updateFromContext(panel: Record<string, unknown>): void;
+    /**
+     * Reset to shopping mode. Returns true if mode was non-shopping before reset.
+     */
+    reset(): boolean;
+    /** Resolve attachment action type based on current mode. */
+    resolveAttachmentActionType(): 'user_message' | 'findSimilar';
+    /** Non-shopping modes condense thinking step lists. */
+    shouldCondenseThinking(): boolean;
+}

package/dist/chat/features/beauty-consulting/registry.d.ts

@@ -0,0 +1,3 @@
+import { UISpecDomRegistry } from '../../../common/renderer/index.js';
+import { ChatUISpecRenderContext } from '../../types.js';
+export declare const beautyConsultingRegistry: Partial<UISpecDomRegistry<ChatUISpecRenderContext>>;

package/dist/chat/features/beauty-consulting/stream-handler.d.ts

@@ -0,0 +1,38 @@
+import { PhotoAnalysisData } from '../../components/PhotoAnalysisCard.js';
+import { ChatMessage } from '../../types.js';
+/** Per-stream state for beauty consulting features. */
+export interface BeautyStreamState {
+    streamIncludedBeautyPhotoStep: boolean;
+    pendingPhotoStepSkip: boolean;
+}
+export declare function createBeautyStreamState(): BeautyStreamState;
+/** Callbacks needed by the beauty stream handler. */
+export interface BeautyStreamContext {
+    drawer: {
+        updateBotMessage(messageId: string, html: string, renderHint?: string, photoAnalysis?: PhotoAnalysisData): void;
+        setBeautyPhotoStepCard(options: {
+            visible: boolean;
+            processing?: boolean;
+            onSkip?: (() => void) | undefined;
+            title?: string | undefined;
+            description?: string | undefined;
+            uploadLabel?: string | undefined;
+            skipLabel?: string | undefined;
+        }): void;
+    } | null;
+    ensureRendered: () => void;
+    cancelTypewriter: () => void;
+    sendSkipMessage: () => void;
+    streamDone: boolean;
+}
+/**
+ * Handle a beauty-specific UISpec component during stream processing.
+ * Returns true if the component was handled (caller should `return`).
+ */
+export declare function handleBeautyUISpec(componentType: string, rootElementProps: Record<string, unknown>, state: BeautyStreamState, ctx: BeautyStreamContext, botMsg: ChatMessage): boolean;
+/** Returns true if the bot message should render as a photo analysis card. */
+export declare function isPhotoAnalysisMessage(botMsg: ChatMessage): boolean;
+/** Flush pending beauty photo step state on stream complete. */
+export declare function flushBeautyStreamComplete(state: BeautyStreamState, ctx: BeautyStreamContext): void;
+/** Flush pending beauty photo step skip on stream error. */
+export declare function flushBeautyStreamError(state: BeautyStreamState, ctx: BeautyStreamContext): void;

package/dist/chat/index.d.ts

@@ -1,6 +1,7 @@
 import { ActionPayload, PageContext } from '../common/types.js';
 import { BaseWidget } from '../common/widget-base.js';
 import { ChatWidgetConfig } from './types.js';
+import { AssistantMode } from './assistant-mode.js';
 /**
  * Floating AI chat widget with streaming NDJSON responses, product cards, and comparison tables.
  *
@@ -109,6 +110,13 @@ export declare class GengageChat extends BaseWidget<ChatWidgetConfig> {
     private _consecutiveErrorCount;
     /** Last error message text for deduplication. */
     private _lastErrorMessage;
+    private _modeController;
+    /** @deprecated Alias for backward compat in tests. Use _modeController.mode. */
+    get _assistantMode(): AssistantMode;
+    set _assistantMode(value: AssistantMode);
+    /** @deprecated Alias for backward compat in tests. Use _modeController.uiHints. */
+    get _uiHints(): Record<string, unknown> | null;
+    set _uiHints(value: Record<string, unknown> | null);
     protected onInit(config: ChatWidgetConfig): Promise<void>;
     protected onUpdate(context: Partial<PageContext>): void;
     protected onShow(): void;
@@ -196,6 +204,9 @@ export declare class GengageChat extends BaseWidget<ChatWidgetConfig> {
     private _handleAttachment;
     private _sendMessage;
     private _flushQueuedUserMessages;
+    /** Apply ui_hints from the backend CONTEXT event — delegates to mode controller. */
+    private _applyUiHints;
+    private _handleRedirectMetadata;
     private _sendAction;
     /** Return messages visible at the current thread cursor. */
     private _getVisibleMessages;
@@ -291,4 +302,3 @@ export type { ChatCatalog, ChatComponentName } from './catalog.js';
 export { getChatScrollElement, invalidateChatScrollCache, CHAT_SCROLL_ELEMENT_ID, } from './utils/get-chat-scroll-element.js';
 export { ChatPresentationState } from './chat-presentation-state.js';
 export type { GroupReadState, PresentationGroupMeta, ScrollRequest } from './chat-presentation-state.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/chat/kvkk.d.ts

@@ -18,4 +18,3 @@ export declare function markKvkkShown(accountId: string): void;
 export declare function stripKvkkBlock(html: string): string;
 export declare function extractKvkkBlock(html: string): string | null;
 export declare function localeToOutputLanguage(locale?: string): string;
-//# sourceMappingURL=kvkk.d.ts.map

package/dist/chat/locales/en.d.ts

@@ -1,3 +1,2 @@
 import { ChatI18n } from '../types.js';
 export declare const CHAT_I18N_EN: ChatI18n;
-//# sourceMappingURL=en.d.ts.map

package/dist/chat/locales/index.d.ts

@@ -3,4 +3,3 @@ import { CHAT_I18N_TR } from './tr.js';
 import { CHAT_I18N_EN } from './en.js';
 export declare function resolveChatLocale(locale?: string): ChatI18n;
 export { CHAT_I18N_TR, CHAT_I18N_EN };
-//# sourceMappingURL=index.d.ts.map

package/dist/chat/locales/tr.d.ts

@@ -1,3 +1,2 @@
 import { ChatI18n } from '../types.js';
 export declare const CHAT_I18N_TR: ChatI18n;
-//# sourceMappingURL=tr.d.ts.map

package/dist/chat/panel-manager.d.ts

@@ -96,4 +96,3 @@ export declare function determinePanelUpdateAction(opts: {
     isPanelLoading: boolean;
     isFirstPanelContentInStream: boolean;
 }): PanelUpdateAction;
-//# sourceMappingURL=panel-manager.d.ts.map

package/dist/chat/session-persistence.d.ts

@@ -62,4 +62,3 @@ export declare class SessionPersistence {
     toggleFavorite(userId: string, appId: string, sku: string, product: Record<string, unknown>): Promise<void>;
     close(): void;
 }
-//# sourceMappingURL=session-persistence.d.ts.map

package/dist/chat/stream-error-display.d.ts

@@ -4,4 +4,3 @@
  * (e.g. output_text with is_error) stay in the conversation as a chat message.
  */
 export declare function shouldShowStreamErrorAsRedStrip(err: Error, displayText: string): boolean;
-//# sourceMappingURL=stream-error-display.d.ts.map