guideai-app 0.5.4-2 → 0.5.4-8

package/dist/hooks/useGuideAIMutePipeline.d.ts

@@ -21,6 +21,7 @@ export interface UseGuideAIMutePipelineParams {
 export declare function useGuideAIMutePipeline({ hooks, isConversationActive, conversationManagerRef, dataChannelManagerRef, mediaStreamRef, audioElementRef, hasMic, isDataChannelOpen, }: UseGuideAIMutePipelineParams): {
     isMuted: boolean;
     handleToggleMute: () => void;
+    applyMicMuted: (muted: boolean) => void;
     applyMuteStateToMediaStreamTracks: () => void;
     isAssistantPlaybackMuted: boolean;
     handleToggleAssistantPlaybackMute: () => void;

package/dist/hooks/useGuideAIThemeState.d.ts

@@ -0,0 +1,6 @@
+import type { GuideAIThemeContextValue } from '../contexts/GuideAIThemeContext';
+import type { GuideAIThemeId } from '../themes/guideAIThemeIds';
+export declare function useGuideAIThemeState(themeProp?: GuideAIThemeId | null): {
+    activeThemeId: GuideAIThemeId | null;
+    themeContextValue: GuideAIThemeContextValue;
+};

package/dist/hooks/useHiddenRealtimeSteers.d.ts

@@ -7,6 +7,8 @@ export interface UseHiddenRealtimeSteersParams {
     isDataChannelOpen: boolean;
     isConversationActive: boolean;
     pendingWorkspaceGreetingRef: MutableRefObject<string | null>;
+    /** When true on connect, send a "what's next" resume steer instead of the greeting. */
+    pendingResumeSteerRef: MutableRefObject<boolean>;
     pendingWorkflowSteerTitle: string | null;
     clearPendingWorkflowSteerTitle: () => void;
     dataChannelManagerRef: MutableRefObject<DataChannelManager | null>;
@@ -19,4 +21,4 @@ export interface UseHiddenRealtimeSteersParams {
  * Hidden `conversation.item.create` + `response.create` for workspace greeting and workflow steer,
  * with Noisy-preset interrupt lock sequencing via `scheduleInterruptLockThenSend`.
  */
-export declare function useHiddenRealtimeSteers({ hooks, isDataChannelOpen, isConversationActive, pendingWorkspaceGreetingRef, pendingWorkflowSteerTitle, clearPendingWorkflowSteerTitle, dataChannelManagerRef, conversationManagerRef, scheduleInterruptLockThenSend, }: UseHiddenRealtimeSteersParams): void;
+export declare function useHiddenRealtimeSteers({ hooks, isDataChannelOpen, isConversationActive, pendingWorkspaceGreetingRef, pendingResumeSteerRef, pendingWorkflowSteerTitle, clearPendingWorkflowSteerTitle, dataChannelManagerRef, conversationManagerRef, scheduleInterruptLockThenSend, }: UseHiddenRealtimeSteersParams): void;

package/dist/hooks/useLauncherTabDrag.d.ts

@@ -0,0 +1,23 @@
+/** Keep in sync with the `.guideai-tab-launcher` height in `guideAIStylesTabLauncher.ts`. */
+export declare const LAUNCHER_TAB_HEIGHT_PX = 64;
+export interface LauncherTabDragResult {
+    /** Current tab offset from the viewport top (px), clamped to the viewport. */
+    tabTopPx: number;
+    /** True while the pointer is down and has crossed the drag threshold. */
+    isDragging: boolean;
+    onTabPointerDown: (event: React.PointerEvent<HTMLDivElement>) => void;
+    onTabPointerMove: (event: React.PointerEvent<HTMLDivElement>) => void;
+    onTabPointerUp: (event: React.PointerEvent<HTMLDivElement>) => void;
+    /** Returns true exactly once after a drag, so the click that follows pointerup is swallowed. */
+    consumeDragClick: () => boolean;
+}
+export interface UseLauncherTabDragParams {
+    /** Per-widget localStorage scope for the persisted vertical offset. */
+    prefsKey: string;
+}
+/**
+ * Vertical drag behavior for the side-tab launcher: pointer-driven `top` offset, viewport
+ * clamping (including on resize), persistence per widget key, and click-vs-drag disambiguation
+ * so releasing a drag does not toggle the conversation.
+ */
+export declare function useLauncherTabDrag(React: typeof import('react'), { prefsKey }: UseLauncherTabDragParams): LauncherTabDragResult;

package/dist/hooks/useMicMute.d.ts

@@ -18,5 +18,6 @@ export interface UseMicMuteParams {
 export declare function useMicMute({ hooks, mediaStreamRef, conversationManagerRef, hasMic, isConversationActive, onMicManuallyUnmuted, }: UseMicMuteParams): {
     isMuted: boolean;
     handleToggleMute: () => void;
+    applyMicMuted: (muted: boolean) => void;
     applyMuteStateToMediaStreamTracks: () => void;
 };

package/dist/hooks/useSessionRating.d.ts

@@ -0,0 +1,21 @@
+import type { MutableRefObject } from 'react';
+import type { ReactHooks } from '../utils/reactHooks';
+import type { ConversationManager } from '../utils/conversationManager';
+type UseSessionRatingParams = {
+    hooks: ReactHooks;
+    conversationManagerRef: MutableRefObject<ConversationManager | null>;
+};
+export declare function useSessionRating({ hooks, conversationManagerRef }: UseSessionRatingParams): {
+    isVisible: boolean;
+    isClosing: boolean;
+    promptTitle: string;
+    showCommentField: boolean;
+    comment: string;
+    setComment: import("react").Dispatch<import("react").SetStateAction<string>>;
+    maybeOpenSessionRating: (conversationId: string, sessionDurationMs: number) => void;
+    submitRating: (stars: number) => void;
+    dismiss: () => void;
+    handleTellUsMoreClick: () => void;
+    reset: () => void;
+};
+export {};

package/dist/hooks/useSubtitleAppearancePrefs.d.ts

@@ -0,0 +1,5 @@
+import type { ReactHooks } from '../utils/reactHooks';
+export declare function useSubtitleAppearancePrefs(hooks: ReactHooks): {
+    subtitleDarkHighlight: boolean;
+    setSubtitleDarkHighlight: (enabled: boolean) => void;
+};

package/dist/hooks/useThemePortalProps.d.ts

@@ -0,0 +1,4 @@
+/** `data-guideai-theme` for menus portaled to `document.body`. */
+export declare function useThemePortalProps(): {
+    'data-guideai-theme'?: string;
+};

package/dist/hooks/useTranscriptChrome.d.ts

@@ -11,7 +11,8 @@ export type UseTranscriptChromeParams = {
     layoutPrefsKey: string;
     showTranscript: boolean;
     workspaceOptions: StubWorkspaceOption[];
-    workspaceDataSource: 'stub' | 'api';
+    /** When true, workspace catalog and workflows come from the API. */
+    catalogFromApi: boolean;
     apiWorkflowsByWorkspaceId: Record<string, StubWorkflowItem[]> | null;
     keyTrim: string;
     hasPortalAuth: boolean;
@@ -30,10 +31,14 @@ export type TranscriptChrome = {
     setTranscriptSessionMode: Dispatch<SetStateAction<TranscriptSessionMode>>;
     setWorkflowDrawerOpen: Dispatch<SetStateAction<boolean>>;
     handleToggleTranscriptPanelMode: () => void;
+    /** Float → dock (e.g. drag float card past the right viewport edge). */
+    handleDockTranscriptPanel: () => void;
+    /** Dock → float (e.g. drag docked panel away from the right edge). */
+    handleUndockTranscriptPanel: () => void;
     handleTranscriptSessionModeChange: (mode: TranscriptSessionMode) => void;
 };
 /**
  * Transcript dock/float preference, workflow drawer visibility, and workspace session mode
  * (including reconnect + first workflow steer after mode change).
  */
-export declare function useTranscriptChrome({ hooks, layoutPrefsKey, showTranscript, workspaceOptions, workspaceDataSource, apiWorkflowsByWorkspaceId, keyTrim, hasPortalAuth, reestablishRealtimeSessionRef, queueWorkflowSteerTitle, clearPendingWorkflowSteerTitle, conversationManagerRef, sessionWorkflowIdForInitRef: sessionWorkflowIdForInitRefProp, }: UseTranscriptChromeParams): TranscriptChrome;
+export declare function useTranscriptChrome({ hooks, layoutPrefsKey, showTranscript, workspaceOptions, catalogFromApi, apiWorkflowsByWorkspaceId, keyTrim, hasPortalAuth, reestablishRealtimeSessionRef, queueWorkflowSteerTitle, clearPendingWorkflowSteerTitle, conversationManagerRef, sessionWorkflowIdForInitRef: sessionWorkflowIdForInitRefProp, }: UseTranscriptChromeParams): TranscriptChrome;

package/dist/hooks/useTranscriptDisplayMode.d.ts

@@ -0,0 +1,6 @@
+import type { TranscriptDisplayMode } from '../types/GuideAI.types';
+import type { ReactHooks } from '../utils/reactHooks';
+export declare function useTranscriptDisplayMode(hooks: ReactHooks): {
+    transcriptDisplayMode: TranscriptDisplayMode;
+    setTranscriptDisplayMode: (mode: TranscriptDisplayMode) => void;
+};

package/dist/hooks/useTranscriptPanelDragResize.d.ts

@@ -0,0 +1,47 @@
+import type { CSSProperties, PointerEvent as ReactPointerEvent, RefObject } from 'react';
+import type { ReactHooks } from '../utils/reactHooks';
+import { type FloatResizeCorner } from '../utils/transcriptFloatGeometry';
+export type TranscriptWorkflowStripGestureHandlers = {
+    onPointerDown: (e: ReactPointerEvent<HTMLButtonElement>) => void;
+    onPointerMove: (e: ReactPointerEvent<HTMLButtonElement>) => void;
+    onPointerUp: (e: ReactPointerEvent<HTMLButtonElement>) => void;
+    onPointerCancel: (e: ReactPointerEvent<HTMLButtonElement>) => void;
+};
+export type UseTranscriptPanelDragResizeParams = {
+    hooks: Pick<ReactHooks, 'useState' | 'useEffect' | 'useLayoutEffect' | 'useRef' | 'useCallback' | 'useMemo'>;
+    isDockedPanel: boolean;
+    showTranscript: boolean;
+    workflowDrawerOpen: boolean;
+    drawerWidthPx: number;
+    onDrawerWidthChange?: (widthPx: number) => void;
+    onDockTranscriptPanel: () => void;
+    onUndockTranscriptPanel: () => void;
+    /** Tap on workflow handle when drag did not start (toggle workflow drawer). */
+    onToggleWorkflowDrawer: () => void;
+    /** Per-conversation key for persisting float geometry; cleared on conversation end. */
+    persistKey: string;
+};
+export type TranscriptPanelDragResize = {
+    transcriptBoxRef: RefObject<HTMLDivElement>;
+    floatSettling: boolean;
+    floatDragging: boolean;
+    floatResizeDragging: boolean;
+    /** True on the first paint when a persisted geometry is restored (suppress entry animation). */
+    enterAnimSuppressed: boolean;
+    floatStripGestureHandlers: TranscriptWorkflowStripGestureHandlers | undefined;
+    dockStripGestureHandlers: TranscriptWorkflowStripGestureHandlers | undefined;
+    onFloatCornerPointerDown: (corner: FloatResizeCorner) => (e: ReactPointerEvent<HTMLDivElement>) => void;
+    onDrawerResizePointerDown: (e: ReactPointerEvent<HTMLDivElement>) => void;
+    /**
+     * Float-only positioning style (bottom-left anchored). `null` => no custom geometry yet,
+     * caller applies the default responsive corner anchor.
+     */
+    floatBoxStyle: CSSProperties | null;
+};
+/**
+ * Float transcript card drag / resize / dock with a single bottom-left pixel-geometry source of
+ * truth, viewport snapping on release, viewport-capped resize, persistence, and a tiny-threshold
+ * docked→float undock. Direct DOM writes during a gesture (rAF-batched) keep React renders out of
+ * the hot path; state is committed once on release.
+ */
+export declare function useTranscriptPanelDragResize({ hooks, isDockedPanel, showTranscript, workflowDrawerOpen, drawerWidthPx, onDrawerWidthChange, onDockTranscriptPanel, onUndockTranscriptPanel, onToggleWorkflowDrawer, persistKey, }: UseTranscriptPanelDragResizeParams): TranscriptPanelDragResize;

package/dist/hooks/useWebRTC.d.ts

@@ -8,6 +8,7 @@ import { ConversationManager } from '../utils/conversationManager';
 import type { RecordingStatus } from '../types/GuideAI.types';
 import type { GuideAIEnvironment } from '../types/GuideAI.types';
 import type { StoredMessage } from '../utils/messageStorage';
+import type { MutableRefObject } from 'react';
 export type PropTools = Record<string, {
     description: string;
     parameters: object;
@@ -67,6 +68,12 @@ export interface UseWebRTCParams {
     workspaceGreetingRef?: {
         current: string | null;
     };
+    /**
+     * Workspace visual-context policy from each `/initialize` response. `undefined` means a
+     * legacy server omitted the field (host prop / default applies). Fires on every session
+     * (re)connect so workspace switches re-apply the new workspace's policy.
+     */
+    onVisualContextPolicy?: (enabled: boolean | undefined) => void;
     /** Fire-and-forget workspace catalog fetch in parallel with initialize (after access-key session if any). */
     onWorkspaceCatalogPrefetch?: () => void;
     /** Read at connect — published workflow id for /initialize (null = server default). */
@@ -77,6 +84,8 @@ export interface UseWebRTCParams {
     rollupWorkflowsForInitRef?: {
         current: boolean;
     };
+    /** Filled by `useConversationSession`; used to renew WebRTC after `session_expired`. */
+    reestablishRealtimeSessionRef?: MutableRefObject<((callOptions?: InitializeWebRTCCallOptions) => Promise<boolean>) | null>;
 }
 /** One-shot options for a single `initializeWebRTC` call (e.g. reconnect before React commits new workspace). */
 export type InitializeWebRTCCallOptions = {

package/dist/hooks/useWidgetWorkflowSession.d.ts

@@ -1,6 +1,7 @@
 import type { MutableRefObject } from 'react';
 import type { TranscriptSessionMode } from '../types/GuideAI.types';
 import type { StubWorkspaceOption } from '../stubs/workspaces';
+import type { ConversationManager } from '../utils/conversationManager';
 import type { ReactHooks } from '../utils/reactHooks';
 import type { InitializeWebRTCCallOptions } from './useWebRTC';
 export type UseWidgetWorkflowSessionParams = {
@@ -14,6 +15,7 @@ export type UseWidgetWorkflowSessionParams = {
     sessionWorkflowIdForInitRef?: MutableRefObject<string | null>;
     /** Filled after `reestablishActiveRealtimeSession` is defined; read at call time. */
     reestablishRef: MutableRefObject<((callOptions?: InitializeWebRTCCallOptions) => Promise<boolean>) | null>;
+    conversationManagerRef: MutableRefObject<ConversationManager | null>;
     /**
      * Optional shared ref (e.g. with `useTranscriptChrome`) so clearing workflow id on session mode
      * change stays in sync. Takes precedence over `sessionWorkflowIdForInitRef` when both are set.

package/dist/hooks/useWorkflowTesterOverlay.d.ts

@@ -1,15 +1,15 @@
 import type { ReactHooks } from '../utils/reactHooks';
-export interface UseWorkflowTesterOverlayParams {
+/**
+ * Workflow tester → same `queueWorkflowSteerTitle` path as transcript workflow focus.
+ * {@link useWorkflowTesterSteerBridge} assigns {@link queueWorkflowSteerForWorkflowTester.current}.
+ */
+export declare const queueWorkflowSteerForWorkflowTester: {
+    current: ((workflowStepLabel: string) => void) | null;
+};
+export interface UseWorkflowTesterSteerBridgeParams {
     hooks: ReactHooks;
     /** Same `queueWorkflowSteerTitle` as transcript workflow focus; wired to the workflow tester bridge. */
     queueWorkflowSteerTitle?: (title: string) => void;
 }
-/**
- * Transcript ⋯ → Debug → workflow tester panel: visibility (localStorage + cross-tab sync), close, toggle.
- * When `queueWorkflowSteerTitle` is provided, assigns {@link queueWorkflowSteerForWorkflowTester} for the panel.
- */
-export declare function useWorkflowTesterOverlay({ hooks, queueWorkflowSteerTitle, }: UseWorkflowTesterOverlayParams): {
-    visible: boolean;
-    close: () => void;
-    toggle: () => void;
-};
+/** Wires workflow tester steer enqueue to transcript `queueWorkflowSteerTitle`. */
+export declare function useWorkflowTesterSteerBridge({ hooks, queueWorkflowSteerTitle, }: UseWorkflowTesterSteerBridgeParams): void;

package/dist/hooks/useWorkspaceCatalog.d.ts

@@ -18,6 +18,7 @@ export type UseWorkspaceCatalogParams = {
     setApiWorkspaceOptions: Dispatch<SetStateAction<StubWorkspaceOption[] | null>>;
     setApiWorkflowsByWorkspaceId: Dispatch<SetStateAction<Record<string, StubWorkflowItem[]> | null>>;
     setTranscriptSessionMode: Dispatch<SetStateAction<TranscriptSessionMode>>;
+    setCatalogFatal: Dispatch<SetStateAction<boolean>>;
 };
 /**
  * Workspace catalog fetch coalescing, pending-apply when the conversation is active but the data

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import GuideAI from './GuideAI';
 import TranscriptBox from './components/TranscriptBox';
 export default GuideAI;
 export { TranscriptBox };
-export type { GuideAIProps, GuideAIHostUserInfo, GuideAIEnvironment, TranscriptSessionMode, TranscriptPanelMode, MicPromptAnimationId, MicPromptPillExpandId, } from './types/GuideAI.types';
+export type { GuideAIProps, GuideAIHostUserInfo, GuideAIEnvironment, GuideAILauncherOptions, GuideAILauncherTabSide, GuideAILauncherVariant, GuideAIThemeId, TranscriptSessionMode, TranscriptPanelMode, MicPromptAnimationId, MicPromptPillExpandId, } from './types/GuideAI.types';
 export { MIC_PROMPT_ANIMATION_IDS, MIC_PROMPT_PILL_EXPAND_IDS, isMicPromptPillExpand, } from './types/GuideAI.types';
 export * from './visualContext';
 export * from './visualContext/types';
@@ -13,3 +13,6 @@ export { WIDGET_BEARER_TOKEN_STORAGE_KEY, type StoredWidgetBearerRecord, } from
 export { clearStoredWidgetSession } from './utils/widgetSession';
 export { type WidgetWorkspaceRow, type WidgetWorkspacesResponse, postWidgetProfile, } from './utils/api';
 export { runHostUserInfoSync, resetWidgetEndUserIdentity, GUIDEAI_HOST_USERINFO_REFRESH_EVENT, } from './utils/hostUserIdentity';
+export { GUIDEAI_THEME_IDS, isGuideAIThemeId } from './themes/guideAIThemeIds';
+export { GUIDEAI_PRESET_THEMES, GUIDEAI_LIGHT_PRESETS, GUIDEAI_DARK_PRESETS, } from './themes/presetThemes';
+export type { GuideAIThemePreset } from './themes/themeTokens.types';

package/dist/lib/workspaceEmbedIcons.d.ts

@@ -47,7 +47,6 @@ declare const ICON_MAP: {
     readonly video: LucideIcon;
 };
 export type WorkspaceEmbedIconId = keyof typeof ICON_MAP;
-export declare const WORKSPACE_EMBED_ICON_IDS: WorkspaceEmbedIconId[];
 export declare function isWorkspaceEmbedIconId(id: string): id is WorkspaceEmbedIconId;
 export declare const DEFAULT_WORKSPACE_EMBED_ICON: WorkspaceEmbedIconId;
 export declare function WorkspaceEmbedIcon({ iconId, className }: {

package/dist/playwrightBuddyHarness.d.ts

@@ -0,0 +1,12 @@
+import type { BuddyState } from './buddy/types';
+export type PlaywrightBuddyHarness = {
+    executeTool: (name: string, args: string) => Promise<unknown>;
+    readState: (userId?: string) => BuddyState;
+    clearState: (userId?: string) => BuddyState;
+    toolNames: readonly string[];
+};
+declare global {
+    interface Window {
+        __GUIDEAI_BUDDY__?: PlaywrightBuddyHarness;
+    }
+}