guideai-app 0.5.4-2 → 0.5.4-3

package/dist/sessionRating.defaults.d.ts

@@ -0,0 +1,4 @@
+/** Minimum active mic session length before showing the post-session rating popup. */
+export declare const SESSION_RATING_MIN_DURATION_MS = 60000;
+/** Minimum time between rating prompts across sessions. */
+export declare const SESSION_RATING_COOLDOWN_MS: number;

package/dist/sessionRatingPrompts.d.ts

@@ -0,0 +1,3 @@
+/** Post-session rating popup title pool (one picked per popup open). */
+export declare const SESSION_RATING_PROMPTS: readonly string[];
+export declare function pickSessionRatingPrompt(): string;

package/dist/staticContext/useStaticContext.d.ts

@@ -16,7 +16,6 @@
  *     context, including `idle` / `playing` statuses. VC rules are unchanged.
  */
 import { StaticContextConfig, StaticContextPayload } from './types';
-export type StaticContextRecordingStatus = 'idle' | 'recording' | 'active' | 'processing' | 'playing';
 export interface UseStaticContextParams {
     options?: StaticContextConfig;
     /** Whether Visual Context is also enabled. When `true`, VC owns the

package/dist/stubs/workspaces.d.ts

@@ -3,6 +3,8 @@ export type WorkspaceIconId = string;
 export interface StubWorkspaceOption {
     /** Workspace slug (stub modes use onboarding | training | doIt). */
     id: string;
+    /** Server workspace UUID when the catalog API provides it; otherwise omitted. */
+    workspaceId?: string;
     label: string;
     icon: WorkspaceIconId;
     /** Shown under the selector pill and in the workflow drawer header (stub until server-driven). */
@@ -32,5 +34,3 @@ export interface StubWorkflowItem {
     id: string;
     label: string;
 }
-export declare function getStubWorkspaceOptions(): StubWorkspaceOption[];
-export declare function getStubWorkflowsForWorkspace(workspaceId: string): StubWorkflowItem[];

package/dist/styles/guideAIThemeTokens.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Default theme tokens on the widget root (Studio blue). The `theme` prop overrides
+ * these on `[data-guideai-root][data-guideai-theme="{id}"]`.
+ */
+export declare const guideAIThemeTokenDefaults: () => string;

package/dist/styles/guideaiTestsiteWidgetTheme.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Widget theme shared by testsite (`app/globals.css`) and the Chrome extension shadow root.
+ * Shadow DOM cannot read host-page CSS variables, so the extension injects this block explicitly.
+ */
+export declare const GUIDEAI_TESTSITE_MIC_COLOR: "#8b5cf6";
+export declare const GUIDEAI_TESTSITE_WIDGET_THEME_CSS: string;

package/dist/themes/buildThemeCss.d.ts

@@ -0,0 +1,8 @@
+import type { GuideAIThemeTokenSet } from './themeTokens.types';
+/**
+ * Theme stylesheet: set CSS variables on the widget root and portaled menus.
+ * Transcript chrome reads tokens from `guideAIStylesTranscript.ts` (no per-theme selectors).
+ */
+export declare function buildThemeCss(themeId: string, tokens: GuideAIThemeTokenSet): string;
+/** Base bundle tokens when no `theme` prop / preset stylesheet is active. */
+export declare function buildPackageDefaultThemeCss(tokens: GuideAIThemeTokenSet): string;

package/dist/themes/guideAIThemeIds.d.ts

@@ -0,0 +1,5 @@
+import { GUIDEAI_PRESET_THEMES } from './presetThemes';
+/** Built-in theme ids accepted by the `theme` prop. */
+export declare const GUIDEAI_THEME_IDS: readonly string[];
+export type GuideAIThemeId = (typeof GUIDEAI_PRESET_THEMES)[number]['id'];
+export declare function isGuideAIThemeId(value: string): value is GuideAIThemeId;

package/dist/themes/presetThemes.d.ts

@@ -0,0 +1,10 @@
+import type { GuideAIThemePreset, GuideAIThemeTokenSet } from './themeTokens.types';
+/** Package default palette and `theme="dark"` (Studio blue). */
+export declare const GUIDEAI_PACKAGE_DEFAULT_THEME_ID: "dark";
+export declare const GUIDEAI_PRESET_THEMES: GuideAIThemePreset[];
+export declare const GUIDEAI_LIGHT_PRESETS: GuideAIThemePreset[];
+export declare const GUIDEAI_DARK_PRESETS: GuideAIThemePreset[];
+export declare function getPresetThemeCss(themeId: string): string | null;
+export declare function getPresetTheme(themeId: string): GuideAIThemePreset | null;
+/** Tokens for the package default (Studio blue) when no preset stylesheet is applied. */
+export declare function getPackageDefaultThemeTokens(): GuideAIThemeTokenSet;

package/dist/themes/syncGuideAITheme.d.ts

@@ -0,0 +1,2 @@
+/** Apply a bundled preset theme, or restore package default tokens when `themeId` is null/undefined. */
+export declare function syncGuideAITheme(themeId: string | null | undefined): void;

package/dist/themes/themeTokens.types.d.ts

@@ -0,0 +1,37 @@
+/** CSS custom properties set on `[data-guideai-root][data-guideai-theme="…"]`. */
+export type GuideAIThemeTokenSet = {
+    '--guideai-t-shell-bg': string;
+    '--guideai-t-shell-border': string;
+    '--guideai-t-shell-shadow': string;
+    '--guideai-t-text-primary': string;
+    '--guideai-t-text-muted': string;
+    '--guideai-t-accent': string;
+    '--guideai-t-accent-bright': string;
+    '--guideai-t-accent-ring': string;
+    '--guideai-t-surface-elevated': string;
+    '--guideai-t-surface-elevated-ai': string;
+    '--guideai-t-surface-input': string;
+    '--guideai-t-input-border': string;
+    '--guideai-t-input-border-focus': string;
+    '--guideai-t-messages-bg': string;
+    '--guideai-t-menu-bg': string;
+    '--guideai-t-menu-selected': string;
+    '--guideai-t-toolbar-border': string;
+    '--guideai-t-onboarding-bg': string;
+    '--guideai-t-onboarding-shadow': string;
+    '--guideai-t-welcome-bg': string;
+    /** Footer corner mic button (VAD bars / muted glyph). */
+    '--guideai-t-session-mic-bg': string;
+    '--guideai-t-session-mic-border': string;
+    '--guideai-t-session-mic-inset': string;
+    '--guideai-t-session-mic-shadow': string;
+    '--guideai-t-session-mic-muted': string;
+    '--guideai-t-session-level-bar': string;
+    '--guideai-t-session-level-axis': string;
+};
+export type GuideAIThemePreset = {
+    id: string;
+    label: string;
+    group: 'light' | 'dark';
+    tokens: GuideAIThemeTokenSet;
+};

package/dist/types/GuideAI.types.d.ts

@@ -38,6 +38,9 @@ export type MicButtonPosition = GuideAIPosition;
 export type GuideAIHostUserInfo = {
     username?: string | null;
 } & Record<string, unknown>;
+export type { GuideAIThemeId } from '../themes/guideAIThemeIds';
+import type { ExtensionPortalAuthProp } from '../devtools/devtoolsAuth/types';
+import type { GuideAIThemeId } from '../themes/guideAIThemeIds';
 export interface GuideAIProps {
     /**
      * Optional lightweight snapshot of the signed-in end user. When `username` is non-empty,
@@ -54,7 +57,11 @@ export interface GuideAIProps {
      * Requires `authKey`, or `widgetSessionToken` with `adminConversationPersistenceKey`.
      */
     authKey?: string;
-    /** Workspace slug when using `authKey` (access-key) auth. */
+    /**
+     * Default workspace slug for the first realtime session (`POST /api/initialize`).
+     * Single slug only — not a comma list. Should match a slug in the effective catalog when
+     * `workspaces` is also set.
+     */
     workspace?: string;
     /**
      * Pre-issued widget Bearer JWT (internal admin / portal tooling). Requires `adminConversationPersistenceKey`.
@@ -71,8 +78,10 @@ export interface GuideAIProps {
     /** Value sent as `user` on `/initialize` when using portal/widget Bearer (e.g. portal AuthUser id). */
     initializeUserId?: string;
     /**
-     * Optional allowlist of workspace slugs for the catalog request; omit to load all workspaces
-     * for the authenticated customer.
+     * Catalog allowlist: limits transcript workspace selector and workflows to these slugs.
+     * Omit to load all workspaces for the customer. Accepts a comma-separated string
+     * (`"sales,support"`) or `string[]`. If no workspaces resolve (including after falling back
+     * to `workspace`), the widget logs `console.error` and unmounts.
      */
     workspaces?: string | string[];
     environment?: GuideAIEnvironment;
@@ -112,6 +121,16 @@ export interface GuideAIProps {
      * Set to true to allow the widget on those devices.
      */
     mobileEnabled?: boolean;
+    /**
+     * Chrome extension popup portal JWT + user (from `chrome.storage.local`).
+     * Used to recognize signed-in administrators and gate developer tools.
+     */
+    extensionPortalAuth?: ExtensionPortalAuthProp;
+    /**
+     * Built-in color theme preset. Omit (or `null`) for the package default palette.
+     * See README **Themes** for available ids.
+     */
+    theme?: GuideAIThemeId | null;
 }
 export type TranscriptPosition = 'right' | 'left';
 /**

package/dist/utils/api.d.ts

@@ -59,7 +59,10 @@ export declare const registerTools: (endpoint: string, payload: {
 export declare const logMessage: (messageData: MessageData, conversationId: string | null, _conversationKey: string, user?: string, environment?: GuideAIEnvironment) => Promise<void>;
 /** One workspace row from `POST /widget/workspaces` (normalized). */
 export interface WidgetWorkspaceRow {
+    /** Workspace slug (transcript session key / initialize body `workspace`). */
     id: string;
+    /** Server workspace UUID when the API provides it separately from slug. */
+    workspaceId?: string;
     label: string;
     description: string;
     icon: string;

package/dist/utils/api.learn.d.ts

@@ -0,0 +1,18 @@
+import { type InitializeWebRTCOptions } from './api';
+export interface InitializeLearnWebRTCPayload {
+    sdp: string;
+    workspace?: string;
+    user?: string;
+    phase?: 'capture' | 'clarify';
+    /** Clarify re-init: reuse capture conversation for logging and generate. */
+    conversationId?: string;
+}
+export interface InitializeLearnWebRTCResponse {
+    answerSdp: string;
+    id: string;
+    contextKey?: string;
+    transcriptionModel?: string;
+    greeting?: string | null;
+}
+/** Learn mode realtime init — no workflows or tools. */
+export declare function initializeLearnWebRTC(endpoint: string, payload: InitializeLearnWebRTCPayload, options?: InitializeWebRTCOptions): Promise<InitializeLearnWebRTCResponse>;

package/dist/utils/conversationContextSwitch.d.ts

@@ -0,0 +1,41 @@
+import type { StubWorkspaceOption } from '../stubs/workspaces';
+export declare function isUuidString(value: string): boolean;
+export type ConversationContextSwitchType = 'workspace' | 'workflow';
+/** Structured `logdata` for workspace/workflow context switches (messages API only). */
+export type ConversationContextSwitchLogdata = {
+    kind: 'conversation_context_switch';
+    switchType: ConversationContextSwitchType;
+    workspaceId: string;
+    workspaceSlug: string;
+    workspaceTitle: string;
+    workflowId?: string;
+    workflowName?: string;
+};
+export type WorkspaceContextFields = {
+    workspaceId: string;
+    workspaceSlug: string;
+    workspaceTitle: string;
+};
+/** Human-readable SYSTEM log line matching admin log conventions. */
+export declare function formatConversationContextSwitchContent(switchType: ConversationContextSwitchType, name: string): string;
+export declare function buildConversationContextSwitchLogdata(params: {
+    switchType: ConversationContextSwitchType;
+    workspace: WorkspaceContextFields;
+    workflowId?: string | null;
+    workflowName?: string | null;
+}): ConversationContextSwitchLogdata;
+/**
+ * Resolves workspace id (UUID when provided by catalog), slug, and title for context-switch logs.
+ */
+export declare function resolveWorkspaceContextFields(workspaceOptions: StubWorkspaceOption[], workspaceSlug: string): WorkspaceContextFields | null;
+/**
+ * Normalizes a widget workspace API row into slug (transcript key) and optional UUID.
+ */
+export declare function resolveWidgetWorkspaceSlugAndId(raw: {
+    id?: string;
+    slug?: string;
+    workspaceId?: string;
+}): {
+    slug: string;
+    workspaceId?: string;
+} | null;

package/dist/utils/conversationManager.d.ts

@@ -1,4 +1,6 @@
 import { GuideAIEnvironment } from '../types/GuideAI.types';
+import { type ConversationContextSwitchType, type WorkspaceContextFields } from './conversationContextSwitch';
+export type { ConversationContextSwitchLogdata, ConversationContextSwitchType, } from './conversationContextSwitch';
 /**
  * Message type options
  */
@@ -25,6 +27,26 @@ export interface WorkflowTesterSessionResult {
     queueCompleted: number;
     errorMessage?: string | null;
 }
+export type LearnClickLogdata = {
+    kind: 'learn_click';
+    selector: string;
+    href?: string;
+    pathname?: string;
+    timestamp?: number;
+    label?: string;
+};
+export type LearnCaptureMarkerLogdata = {
+    kind: 'learn_capture_start';
+} | {
+    kind: 'learn_capture_end';
+};
+export type SessionRatingOutcome = 'rated' | 'dismissed' | 'ignored';
+export type SessionRatingLogdata = {
+    kind: 'session_rating';
+    outcome: SessionRatingOutcome;
+    rating?: number;
+    comment?: string;
+};
 /** Structured `logdata` for workflow tester markers (messages API only, not transcript storage). */
 export type WorkflowTesterSessionLogdata = {
     kind: 'workflow_tester';
@@ -105,6 +127,9 @@ export declare class ConversationManager {
      * posts to the messages API with structured `logdata` for the admin log; not stored in the widget transcript.
      */
     logWorkflowTesterSessionMarker(logdata: WorkflowTesterSessionLogdata): void;
+    /** Host-page click during Learn capture — stored in transcript + messages API. */
+    logLearnClickMessage(data: LearnClickLogdata): void;
+    logLearnCaptureMarker(marker: LearnCaptureMarkerLogdata): void;
     /**
      * Public wrapper - log action message
      */
@@ -129,4 +154,20 @@ export declare class ConversationManager {
      * type until/unless a dedicated MessageType is added.
      */
     logStaticContextMessage(content: string, payload?: any): void;
+    /**
+     * Workspace or workflow context switch — SYSTEM `log` with structured `logdata` for the admin
+     * messages log (not stored in the widget transcript).
+     */
+    /** Post-session star rating (messages API only; not stored in widget transcript). */
+    logSessionRating(params: {
+        outcome: SessionRatingOutcome;
+        rating?: number;
+        comment?: string;
+    }): void;
+    logConversationContextSwitch(params: {
+        switchType: ConversationContextSwitchType;
+        workspace: WorkspaceContextFields;
+        workflowId?: string | null;
+        workflowName?: string | null;
+    }): void;
 }

package/dist/utils/dataChannel.d.ts

@@ -13,6 +13,8 @@ export interface DataChannelCallbacks {
     onDataChannelClose: (pc: RTCPeerConnection) => void;
     onDataChannelError: (event: Event) => void;
     onDataChannelMessageError: (message: any) => void;
+    /** Realtime session hit max duration (`session_expired`); host should reconnect via /initialize. */
+    onSessionExpired?: () => void;
     setIsResponseActive: (active: boolean) => void;
     updateStreamingMessage: (delta: string) => void;
     /** Reset streaming state when a new response starts (call on response.created) */
@@ -34,6 +36,10 @@ export interface DataChannelCallbacks {
 export interface DataChannelConfig {
     audioStream: MediaStream | null;
     callbacks: DataChannelCallbacks;
+    /** When `.current === 'capturing'`, clamp assistant text to OK only. */
+    learnCapturePhaseRef?: {
+        current: string | null;
+    };
     /** Input audio transcription model; overridden by setTranscriptionModel from /initialize response when present */
     transcriptionModel?: string;
     /** Tools from server (initialize response). If undefined = old server, use built-in. If [] = new server, no tools. */
@@ -74,7 +80,9 @@ export declare class DataChannelManager {
     private deferredInterruptLockThenGreeting;
     /** After sending VAD-off lock `session.update`, wait for next `session.updated` before greeting. */
     private pendingPostInterruptLockCallback;
+    private learnCapturePhaseRef?;
     constructor(config: DataChannelConfig);
+    private clampLearnCaptureAssistantText;
     /** Set from POST /initialize response (call after initialize returns, before data channel open). */
     setTranscriptionModel(model: string): void;
     /** Set tools from server (call after initialize, before channel opens) */

package/dist/utils/dataChannelHelpers.d.ts

@@ -2,6 +2,16 @@
  * Helper functions for data channel message handling.
  * Extracted from dataChannel.ts to keep the main module focused on orchestration.
  */
+/** OpenAI Realtime `error` event payload (`type: 'error'`). */
+export type RealtimeErrorEvent = {
+    error?: {
+        code?: string;
+        message?: string;
+        type?: string;
+    };
+};
+/** True when the server reports the 60-minute realtime session cap (`session_expired`). */
+export declare function isSessionExpiredRealtimeError(message: unknown): boolean;
 /** Minimal sender surface for injecting context-only Realtime items (no `response.create`). */
 export interface SilentRealtimeNoteSender {
     isOpen(): boolean;

package/dist/utils/guideaiMirroredStorageKeys.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Canonical GuideAI localStorage key strings.
+ * Imported by guide-ai-package helpers and the Chrome extension (UMD does not export STORAGE_KEYS).
+ */
+/** Widget Bearer JWT — mirrored; not part of transcript prefs. */
+export declare const WIDGET_BEARER_TOKEN_STORAGE_KEY = "guideai_widgetBearerToken";
+export declare const GUIDEAI_STORAGE_KEYS: {
+    readonly USER_UUID: "guideAI_userUUID";
+    /** Persisted widget profile username (email or stable id); mirrored by the Chrome extension. */
+    readonly WIDGET_PROFILE_USERNAME: "guideAI_widgetProfileUsername";
+    readonly SESSION_ID: "guideAI_sessionId";
+    readonly CONVERSATION: "guideAI_conversation";
+    readonly HAS_INTERACTED: "guideAI_hasInteracted";
+    readonly IS_MUTED: "guideAI_isMuted";
+    /** Mute assistant TTS / remote audio (WebRTC playback); not the user microphone. */
+    readonly ASSISTANT_PLAYBACK_MUTED: "guideAI_assistantPlaybackMuted";
+    readonly LOGGER_ENABLED: "guideAI_loggerEnabled";
+    readonly AUDIO_CONFIG: "guideAI_audioConfig";
+    /** UI microphone preset selector (Precise vs Noisy). */
+    readonly MIC_PRESET: "guideAI_micPreset";
+    /** Developer tools shell: playback interrupt lock panel visibility (default off). */
+    readonly PLAYBACK_LOCK_DEBUG_OVERLAY: "guideAI_playbackLockDebugOverlay";
+    /** Developer tools shell: workflow tester tab overlay visibility (default off). */
+    readonly WORKFLOW_TESTER_OVERLAY: "guideAI_workflowTesterOverlay";
+    /** Last dragged position of the floating developer tools shell (`{ left, top }` JSON). */
+    readonly DEVTOOLS_SHELL_POSITION: "guideAI_devtoolsShellPosition";
+    /** Last dragged position of learn mode capture focus chrome (`{ left, top }` JSON). */
+    readonly LEARN_CAPTURE_POSITION: "guideAI_learnCapturePosition";
+};
+/**
+ * Keys mirrored from the widget to extension localStorage via `guideai_storage_write`.
+ */
+export declare const GUIDEAI_MIRRORED_STORAGE_KEYS: readonly string[];

package/dist/utils/lastSystemToolCall.d.ts

@@ -1,6 +1,7 @@
-export type LastSystemToolCall = {
+type LastSystemToolCall = {
     name: string;
     argsJson: string;
 };
 export declare function getLastSystemToolCall(): LastSystemToolCall | null;
 export declare function setLastSystemToolCall(name: string, argsJson: string): void;
+export {};

package/dist/utils/localStorageHelper.d.ts

@@ -4,26 +4,19 @@
  */
 declare const STORAGE_KEYS: {
     readonly USER_UUID: "guideAI_userUUID";
-    /** Persisted widget profile username (email or stable id); mirrored by the Chrome extension. */
     readonly WIDGET_PROFILE_USERNAME: "guideAI_widgetProfileUsername";
     readonly SESSION_ID: "guideAI_sessionId";
     readonly CONVERSATION: "guideAI_conversation";
     readonly HAS_INTERACTED: "guideAI_hasInteracted";
     readonly IS_MUTED: "guideAI_isMuted";
-    /** Mute assistant TTS / remote audio (WebRTC playback); not the user microphone. */
     readonly ASSISTANT_PLAYBACK_MUTED: "guideAI_assistantPlaybackMuted";
     readonly LOGGER_ENABLED: "guideAI_loggerEnabled";
     readonly AUDIO_CONFIG: "guideAI_audioConfig";
-    /** UI microphone preset selector (Precise vs Noisy). */
     readonly MIC_PRESET: "guideAI_micPreset";
-    /** Transcript “⋯” debug section (console: GuideAI.debug.showMoreMenu()). */
-    readonly DEBUG_MORE_MENU: "guideAI_debugMoreMenu";
-    /** Transcript ⋯ → Debug: fixed “playback interrupt lock” debug panel (default off). */
     readonly PLAYBACK_LOCK_DEBUG_OVERLAY: "guideAI_playbackLockDebugOverlay";
-    /** Transcript ⋯ → Debug: floating workflow tester panel (default off). */
     readonly WORKFLOW_TESTER_OVERLAY: "guideAI_workflowTesterOverlay";
-    /** Debug: transcript ⋯ — use stub workspaces/workflows vs fetched API catalog. */
-    readonly WORKSPACE_DATA_SOURCE: "guideAI_workspaceDataSource";
+    readonly DEVTOOLS_SHELL_POSITION: "guideAI_devtoolsShellPosition";
+    readonly LEARN_CAPTURE_POSITION: "guideAI_learnCapturePosition";
 };
 /**
  * Emit a custom event when localStorage is written, so the Chrome extension
@@ -120,26 +113,29 @@ export type MicrophonePreset = 'precise' | 'noisy';
 export declare const getMicPreset: () => MicrophonePreset;
 export declare const setMicPreset: (preset: MicrophonePreset) => void;
 /**
- * Whether the transcript more-menu shows a Debug section (audio, visual context, logger, API helpers).
- */
-export declare const getDebugMoreMenuEnabled: () => boolean;
-export declare const setDebugMoreMenuEnabled: (enabled: boolean) => void;
-/**
- * Fixed debug panel: interrupt lock / VAD state (transcript ⋯ → Debug).
+ * Fixed debug panel: interrupt lock / VAD state (developer tools shell).
  * Default hidden until enabled from the menu or localStorage.
  */
 export declare const getPlaybackLockDebugOverlayVisible: () => boolean;
 export declare const setPlaybackLockDebugOverlayVisible: (visible: boolean) => void;
 /**
- * Floating workflow tester panel (transcript ⋯ → Debug). Default hidden until enabled
- * from the menu or localStorage.
+ * Workflow tester overlay visibility (developer tools shell).
+ * Default hidden until the workflow tester tab is active.
  */
 export declare const getWorkflowTesterOverlayVisible: () => boolean;
 export declare const setWorkflowTesterOverlayVisible: (visible: boolean) => void;
-export type WorkspaceDataSource = 'stub' | 'api';
-/** Default is API; localStorage value `'stub'` opts into stub workspaces (debug menu). */
-export declare const getWorkspaceDataSource: () => WorkspaceDataSource;
-export declare const setWorkspaceDataSource: (source: WorkspaceDataSource) => void;
+export type DevtoolsShellPosition = {
+    left: number;
+    top: number;
+};
+export declare const getDevtoolsShellPosition: () => DevtoolsShellPosition | null;
+export declare const setDevtoolsShellPosition: (position: DevtoolsShellPosition) => void;
+export type LearnCapturePosition = {
+    left: number;
+    top: number;
+};
+export declare const getLearnCapturePosition: () => LearnCapturePosition | null;
+export declare const setLearnCapturePosition: (position: LearnCapturePosition) => void;
 /** Default docked drawer width (px). */
 export declare const TRANSCRIPT_DRAWER_WIDTH_PX = 420;
 export declare const TRANSCRIPT_DRAWER_WIDTH_MIN_PX = 260;
@@ -147,6 +143,21 @@ export declare const TRANSCRIPT_DRAWER_WIDTH_MAX_PX = 720;
 /** User-resizable docked drawer width (px), per widget key. */
 export declare const getTranscriptDrawerWidthPref: (widgetKey: string) => number;
 export declare const setTranscriptDrawerWidthPref: (widgetKey: string, widthPx: number) => void;
+/**
+ * Persisted float transcript card geometry (per conversation/widget key): bottom-left anchored
+ * `{ left, bottom, width, coreH }` in viewport px. Restored painted on refresh (no animation).
+ * Per-conversation scope — cleared on conversation end (see `useConversationSession`), unlike the
+ * sticky docked drawer width.
+ */
+export type TranscriptFloatGeometry = {
+    left: number;
+    bottom: number;
+    width: number;
+    coreH: number;
+};
+export declare const getTranscriptFloatGeometryPref: (widgetKey: string) => TranscriptFloatGeometry | null;
+export declare const setTranscriptFloatGeometryPref: (widgetKey: string, geometry: TranscriptFloatGeometry) => void;
+export declare const clearTranscriptFloatGeometryPref: (widgetKey: string) => void;
 /**
  * Whether the user prefers the docked transcript panel when the transcript is visible (per widget key).
  * Storage key remains `guideAI_transcriptDrawerPref:*` for backward compatibility.
@@ -155,6 +166,20 @@ export declare const getTranscriptPanelDockedPref: (widgetKey: string) => boolea
 export declare const setTranscriptPanelDockedPref: (widgetKey: string, docked: boolean) => void;
 export declare const getLastWorkspaceSlugPref: (widgetKey: string) => string | null;
 export declare const setLastWorkspaceSlugPref: (widgetKey: string, slug: string | null) => void;
+/** Per-workspace transcript workflow UI + /initialize focus, scoped by conversation key. */
+export type TranscriptWorkflowWorkspaceState = {
+    /** Focused workflow id (checkbox + separate workflows; rollup uses this for UI/steer only). */
+    sessionWorkflowId: string | null;
+    activeWorkflowTitle?: string | null;
+    /** Checkbox workflow list completion map (workflow id → checked). */
+    workflowChecked?: Record<string, boolean>;
+    /** Snapshot when saved — rollup workspaces omit sessionWorkflowId on /initialize. */
+    rollupWorkflows?: boolean;
+};
+export declare const getTranscriptWorkflowWorkspaceState: (conversationKey: string, workspaceSlug: string) => TranscriptWorkflowWorkspaceState | null;
+export declare const setTranscriptWorkflowWorkspaceState: (conversationKey: string, workspaceSlug: string, state: TranscriptWorkflowWorkspaceState | null) => void;
+/** Cleared when the conversation ends (same scope as last workspace slug). */
+export declare const clearTranscriptWorkflowPrefs: (conversationKey: string) => void;
 /**
  * Export storage keys for reference (read-only)
  */

package/dist/utils/messageStorage.d.ts

@@ -20,13 +20,6 @@ export declare const initializeConversationStorage: (conversationKey: string, co
 export declare const isConversationExpired: (conversationKey: string) => boolean;
 export declare const updateSessionExpiresAt: (conversationKey: string, sessionExpiresAt: number) => void;
 export declare const getConversationId: (conversationKey: string) => string | null;
-/**
- * Drop the stored server conversation id. Reserved for true "new thread" flows; do
- * **not** call this on workspace or workflow switches — the server reuses the existing
- * `Conversation` row across switches and updates `Conversation.workspaceId`
- * conditionally (see `guideaisite/docs/WORKSPACE_EMBED_FLOWS.md`).
- */
-export declare function invalidateStoredServerConversationId(conversationKey: string): void;
 export declare const saveConversationToStorage: (conversation: StoredConversation) => void;
 export declare const loadConversationFromStorage: () => StoredConversation | null;
 export declare const clearConversationStorage: () => void;

package/dist/utils/parseWorkspaceSlugList.d.ts

@@ -0,0 +1,12 @@
+/** Host `workspaces` prop or API `workspaces` body field. */
+export type WorkspaceSlugListInput = string | string[] | undefined | null;
+/**
+ * Parse workspace slug allowlist input.
+ * - `undefined` / `null` → `undefined` (no filter; load all customer workspaces)
+ * - non-empty string → split on `,`, trim, drop empties
+ * - array → trim each element, drop empties
+ * - `""` or all-empty → `[]` (explicit empty allowlist)
+ */
+export declare function parseWorkspaceSlugList(input: WorkspaceSlugListInput): string[] | undefined;
+/** Host passed `workspaces=""` / `[]` — explicit empty catalog (not “load all”). */
+export declare function isExplicitEmptyWorkspaceAllowlist(filter: string[] | undefined): filter is [];

package/dist/utils/pathIncludesAnyRef.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns true if any of the given element refs appears in the composed path of `event`.
+ *
+ * Using `event.composedPath()` instead of `event.target` makes outside-click detection
+ * Shadow-DOM-safe: when a composed event crosses a shadow boundary, `event.target` is
+ * retargeted to the shadow host (so `ref.contains(target)` returns false for every ref
+ * inside the shadow). `composedPath()` returns the un-retargeted ancestor chain, so a
+ * click on a menu option inside the shadow still matches the menu's own ref.
+ */
+export declare function pathIncludesAnyRef(event: Event, refs: ReadonlyArray<{
+    current: HTMLElement | null;
+} | null | undefined>): boolean;

package/dist/utils/sessionRatingThrottle.d.ts

@@ -0,0 +1,3 @@
+/** Rating prompt may run at most once per `SESSION_RATING_COOLDOWN_MS`. */
+export declare function canShowSessionRatingPrompt(): boolean;
+export declare function markSessionRatingPromptShown(): void;

package/dist/utils/themeRegistry.d.ts

@@ -0,0 +1,14 @@
+export type ApplyThemeOptions = {
+    id: string;
+    css: string;
+};
+export declare function themeStyleElementId(themeId: string): string;
+/** Register and activate a bundled theme override stylesheet. */
+export declare function applyTheme({ id, css }: ApplyThemeOptions): void;
+/** Remove the active theme override (package default palette). */
+export declare function clearTheme(): void;
+export declare function getActiveTheme(): string | null;
+/** For menus portaled to `document.body` (outside `[data-guideai-root]`). */
+export declare function guideAIThemePortalAttributes(themeId: string | null): {
+    'data-guideai-theme'?: string;
+};

package/dist/utils/tools/descriptionToHighlightSelector.d.ts

@@ -1,2 +1,2 @@
-export declare function elementToHighlightSelector(element: Element): string;
+export { elementToBestInteractionSelector, resolveInteractionTarget, } from './elementToBestInteractionSelector';
 export declare function resolveDescriptionToHighlightSelector(description: string): string | null;

package/dist/utils/tools/docToForm.d.ts

@@ -22,8 +22,8 @@ export type DocToFormArgs = {
     prompt?: string;
     acceptedTypes?: string;
 };
-/** Gemini 3.1 Flash family (preview); matches `/api/gemini` default unless server overrides. */
-export declare const DOC_TO_FORM_GEMINI_MODEL = "gemini-3.1-flash-lite-preview";
+/** Gemini 3.5 Flash; matches `/api/gemini` default unless server overrides. */
+export declare const DOC_TO_FORM_GEMINI_MODEL = "gemini-3.5-flash";
 /** Shown to the realtime model in the tool output JSON so it acts on the extraction immediately. */
 export declare const DOC_TO_FORM_ASSISTANT_INSTRUCTION = "Here are the extracted details. Call fillForm once with a `fields` array to fill every applicable form field. Do not wait for confirmation.";
 export type DocToFormSuccess = {

package/dist/utils/tools/elementToBestInteractionSelector.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Map a click/pick target to the control we want tools to address (input, select, combobox host, etc.).
+ */
+export declare function resolveInteractionTarget(el: Element): Element;
+/**
+ * Best selector for highlight / learn clicks / ATD Find — prefers combobox:, input:, role:, then id/data, then text/css.
+ */
+export declare function elementToBestInteractionSelector(element: Element): string;
+/** @deprecated Use {@link elementToBestInteractionSelector}; kept for existing imports. */
+export declare function elementToHighlightSelector(element: Element): string;

package/dist/utils/transcriptDisplayModePref.d.ts

@@ -0,0 +1,4 @@
+import type { TranscriptDisplayMode } from '../types/GuideAI.types';
+export declare function getTranscriptDisplayMode(): TranscriptDisplayMode;
+export declare function setTranscriptDisplayMode(mode: TranscriptDisplayMode): void;
+export declare function subscribeTranscriptDisplayMode(onStoreChange: () => void): () => void;