guideai-app 0.5.4-2 → 0.5.4-3

package/dist/GuideAI.js.LICENSE.txt

@@ -1,24 +1,9 @@
 /*!
- * html2canvas 1.4.1 <https://html2canvas.hertzen.com>
- * Copyright (c) 2022 Niklas von Hertzen <https://hertzen.com>
+ * html2canvas-pro 2.0.4 <https://yorickshan.github.io/html2canvas-pro/>
+ * Copyright (c) 2024-present yorickshan and html2canvas-pro contributors
  * Released under MIT License
  */
 
-/*! *****************************************************************************
-    Copyright (c) Microsoft Corporation.
-
-    Permission to use, copy, modify, and/or distribute this software for any
-    purpose with or without fee is hereby granted.
-
-    THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-    REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
-    AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-    INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-    LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
-    OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-    PERFORMANCE OF THIS SOFTWARE.
-    ***************************************************************************** */
-
 /**
  * @license lucide-react v0.469.0 - ISC
  *

package/dist/components/DeveloperTools.d.ts

@@ -3,7 +3,8 @@ import { type DataChannelManager } from '../utils/dataChannel';
 import { type VisualContextInspectorProps } from '../devtools/visualContextInspector';
 import { type PlaybackLockDebugOverlayRootProps } from './PlaybackLockDebugOverlayRoot';
 import AudioConfigDialog from './AudioConfigDialog';
-import { type WorkflowTesterPanelProps } from '../devtools/workflowTester';
+import type { WorkflowTesterPanelProps } from '../devtools/workflowTester';
+import type { LearnModePanelProps } from '../devtools/learn/LearnModePanel';
 import type { DeveloperToolPanelId } from '../devtools/developerToolPanelId';
 type AudioConfigForDeveloperTools = Omit<React.ComponentProps<typeof AudioConfigDialog>, 'React' | 'ReactDOM'>;
 type VisualContextForDeveloperTools = {
@@ -13,7 +14,7 @@ type ToolDiagnosticsForDeveloperTools = {
     /** @see DataChannelManager — not the WebRTC `RTCDataChannel` from `DataChannelManager#getDataChannel()`. */
     getDataChannelManager: () => DataChannelManager | null;
     propToolNames: string[];
-    debugMoreMenu: boolean;
+    developerToolsSectionVisible: boolean;
 };
 export type DeveloperToolsShellState = {
     zIndex: number;
@@ -33,11 +34,12 @@ type DeveloperToolsProps = {
     audioConfig: AudioConfigForDeveloperTools;
     visualContext: VisualContextForDeveloperTools;
     workflowTester: WorkflowTesterPanelProps;
+    learn: LearnModePanelProps;
     shell: DeveloperToolsShellState | null;
 };
 /**
  * Debug / developer-only UI in a **single** draggable shell (icon rail + title select).
  * Opened from the transcript ⋯ “more” menu. Mount as a sibling to mic + transcript.
  */
-export declare function DeveloperTools({ React: R, ReactDOM, toolDiagnostics: { getDataChannelManager, propToolNames, debugMoreMenu }, playbackLock, audioConfig, visualContext, workflowTester, shell, }: DeveloperToolsProps): React.JSX.Element | null;
+export declare function DeveloperTools({ React: R, ReactDOM, toolDiagnostics: { getDataChannelManager, propToolNames, developerToolsSectionVisible }, playbackLock, audioConfig, visualContext, workflowTester, learn, shell, }: DeveloperToolsProps): React.JSX.Element | null;
 export {};

package/dist/components/Microphone.d.ts

@@ -6,6 +6,15 @@ interface MicrophoneProps {
     showOnboarding: boolean;
     handleOnboardingComplete: () => void;
     handleOnboardingClose: () => void;
+    sessionRatingVisible: boolean;
+    sessionRatingClosing: boolean;
+    sessionRatingTitle: string;
+    sessionRatingComment: string;
+    sessionRatingShowCommentField: boolean;
+    onSessionRatingCommentChange: (value: string) => void;
+    onSessionRatingTellUsMore: () => void;
+    onSessionRating: (stars: number) => void;
+    onSessionRatingDismiss: () => void;
     isConnecting: boolean;
     connectionMessage?: string | null;
     status: RecordingStatus;
@@ -17,5 +26,5 @@ interface MicrophoneProps {
     hasInteracted: boolean;
     React: typeof import('react');
 }
-declare const Microphone: ({ componentRef, baseStyles, popupPosition, showOnboarding, handleOnboardingComplete, handleOnboardingClose, isConnecting, connectionMessage, status, handleToggleConversation, showTranscript, hasMic, isMuted, hasInteracted, React, }: MicrophoneProps) => import("react").JSX.Element;
+declare const Microphone: ({ componentRef, baseStyles, popupPosition, showOnboarding, handleOnboardingComplete, handleOnboardingClose, sessionRatingVisible, sessionRatingClosing, sessionRatingTitle, sessionRatingComment, sessionRatingShowCommentField, onSessionRatingCommentChange, onSessionRatingTellUsMore, onSessionRating, onSessionRatingDismiss, isConnecting, connectionMessage, status, handleToggleConversation, showTranscript, hasMic, isMuted, hasInteracted, React, }: MicrophoneProps) => import("react").JSX.Element;
 export default Microphone;

package/dist/components/PlaybackLockDebugOverlayRoot.d.ts

@@ -11,5 +11,5 @@ export interface PlaybackLockDebugOverlayRootProps {
     playbackInterruptDebug: boolean;
     embedded?: boolean;
 }
-/** Wires `useProtectedPlayback` + `usePlaybackLockDebugOverlay` into `PlaybackInterruptLockDebugOverlay`. */
+/** Renders `PlaybackInterruptLockDebugOverlay` from shell-provided playback lock / VAD state. */
 export declare function PlaybackLockDebugOverlayRoot({ zIndex, visible, onClose, micPreset, protectedPlaybackActive, overlayConfig, playbackInterruptDebug, embedded, }: PlaybackLockDebugOverlayRootProps): React.JSX.Element | null;

package/dist/components/SessionRatingPopup.d.ts

@@ -0,0 +1,16 @@
+import type { PopupPosition } from '../types/GuideAI.types';
+export type SessionRatingPopupProps = {
+    position: PopupPosition;
+    isVisible: boolean;
+    isClosing: boolean;
+    title: string;
+    comment: string;
+    showCommentField: boolean;
+    onCommentChange: (value: string) => void;
+    onTellUsMoreClick: () => void;
+    onRate: (stars: number) => void;
+    onDismiss: () => void;
+    React: typeof import('react');
+};
+declare const SessionRatingPopup: ({ position, isVisible, isClosing, title, comment, showCommentField, onCommentChange, onTellUsMoreClick, onRate, onDismiss, React, }: SessionRatingPopupProps) => import("react").JSX.Element | null;
+export default SessionRatingPopup;

package/dist/components/SubtitleInputBar.d.ts

@@ -0,0 +1,23 @@
+import type { RecordingStatus } from '../types/GuideAI.types';
+import type { TranscriptDevtoolsMenuProps } from '../devtools/transcriptDevtoolsMenuProps';
+export type SubtitleInputBarProps = {
+    textInput?: string;
+    setTextInput?: (value: string) => void;
+    handleTextSubmit?: () => void;
+    handleTextKeyPress?: (event: React.KeyboardEvent<HTMLTextAreaElement>) => void;
+    textPlaceholder?: string;
+    connectionMessage?: string | null;
+    isDataChannelOpen?: boolean;
+    isResponseActive?: boolean;
+    isConversationActive?: boolean;
+    onToggleConversation?: () => void;
+    recordingStatus?: RecordingStatus;
+    isConnecting?: boolean;
+    hasMic?: boolean;
+    isMuted?: boolean;
+    handleToggleMute?: () => void;
+    transcriptDevtools?: TranscriptDevtoolsMenuProps;
+    React: typeof import('react');
+};
+/** Compact bottom bar for subtitle mode: mic/session, text input, send, settings. */
+export declare function SubtitleInputBar({ textInput, setTextInput, handleTextSubmit, handleTextKeyPress, textPlaceholder, connectionMessage, isDataChannelOpen, isResponseActive, isConversationActive, onToggleConversation, recordingStatus, isConnecting, hasMic, isMuted, handleToggleMute, transcriptDevtools, React, }: SubtitleInputBarProps): import("react").JSX.Element;

package/dist/components/SubtitleSettingsMenu.d.ts

@@ -0,0 +1,9 @@
+import type { TranscriptDevtoolsMenuProps } from '../devtools/transcriptDevtoolsMenuProps';
+export type SubtitleSettingsMenuProps = {
+    transcriptDevtools?: TranscriptDevtoolsMenuProps;
+    /** `bar` = inline on subtitle input bar; `floating` = fixed bottom-right. */
+    variant?: 'bar' | 'floating';
+    React: typeof import('react');
+};
+/** Settings control for subtitle mode (developer tools + transcript UI). */
+export declare function SubtitleSettingsMenu({ transcriptDevtools, variant, React, }: SubtitleSettingsMenuProps): import("react").JSX.Element;

package/dist/components/TranscriptBox.d.ts

@@ -1,7 +1,7 @@
 import { StoredMessage } from '../utils/messageStorage';
 import { TranscriptPanelMode, TranscriptPosition, MicButtonPosition, TranscriptSessionMode, RecordingStatus } from '../types/GuideAI.types';
 import { type StubWorkflowItem, type StubWorkspaceOption } from '../stubs/workspaces';
-import type { WorkspaceDataSource } from '../utils/localStorageHelper';
+import type { TranscriptDevtoolsMenuProps } from '../devtools/transcriptDevtoolsMenuProps';
 import type { MicPresetId } from '../types/audioConfig.types';
 interface TranscriptBoxProps {
     allMessages: StoredMessage[];
@@ -34,14 +34,9 @@ interface TranscriptBoxProps {
     handleResetChat?: () => void;
     isDataChannelOpen?: boolean;
     isResponseActive?: boolean;
-    /** Console: GuideAI.debug.showMoreMenu() — extra ⋯ menu rows for developers. */
-    debugMoreMenuEnabled?: boolean;
-    /** Transcript ⋯ → Debug: show/hide unified developer tools. */
-    developerToolsMenu?: {
-        shellOpen: boolean;
-        onToggleShell: () => void;
-    } | null;
-    /** Current mic preset (Precise / Noisy); shown in ⋯ flyout when debug menu is on. */
+    /** Transcript ⋯ developer tools menu + embed unlock (toolbar title triple-click). */
+    transcriptDevtools?: TranscriptDevtoolsMenuProps;
+    /** Current mic preset (Precise / Noisy); shown in ⋯ when developer tools menu is on. */
     micPreset?: MicPresetId;
     /** Apply preset from transcript menu: persist, reset stored audio to preset base, live session.update. */
     onApplyMicPreset?: (preset: MicPresetId) => void;
@@ -55,18 +50,22 @@ interface TranscriptBoxProps {
      */
     transcriptPanelMode?: TranscriptPanelMode;
     onToggleTranscriptPanelMode?: () => void;
+    /** Switch float panel to docked (e.g. drag past the right viewport edge). */
+    onDockTranscriptPanel?: () => void;
+    /** Switch docked panel to float (e.g. drag away from the right edge). */
+    onUndockTranscriptPanel?: () => void;
     transcriptSessionMode?: TranscriptSessionMode;
     onTranscriptSessionModeChange?: (mode: TranscriptSessionMode) => void;
     /** Stub list until API-driven; computed once in GuideAI. */
     workspaceOptions: StubWorkspaceOption[];
-    /** Debug ⋯: stub vs API workspace data (toggle writes localStorage). */
-    workspaceDataSource: WorkspaceDataSource;
-    /** Workflow steps for the current workspace; from stubs or future API. */
+    /** Workflow steps for the current workspace from the API catalog. */
     workspaceWorkflows: StubWorkflowItem[];
     workflowDrawerOpen?: boolean;
     onWorkflowDrawerOpenChange: (open: boolean) => void;
     /** Access-key realtime: notify parent of DB workflow id for next initialize (workspace prompt + this step). Label used for rollup silent steer. */
     onSessionWorkflowForRealtimeInit?: (workflowId: string | null, workflowLabel?: string) => void;
+    /** Namespace for sticky workflow prefs (`guideAI_transcriptWorkflowState`). */
+    conversationKey?: string;
     /** Docked drawer width (px); persisted by parent when `onDrawerWidthChange` is used. */
     drawerWidthPx?: number;
     onDrawerWidthChange?: (widthPx: number) => void;

package/dist/components/TranscriptSessionMicLevels.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+export type TranscriptSessionMicLevelsMode = 'standby' | 'live' | 'voice';
+/** Bars around a centerline; inactive modes use index-staggered ripples, voice uses center-out swell delays. */
+export declare function TranscriptSessionMicLevels({ mode }: {
+    mode: TranscriptSessionMicLevelsMode;
+}): React.JSX.Element;
+export declare function shouldUseSessionMicLevels(status: import('../types/GuideAI.types').RecordingStatus, isConnecting: boolean, isMuted: boolean, hasMic: boolean): boolean;
+export declare function sessionMicLevelsMode(status: import('../types/GuideAI.types').RecordingStatus): TranscriptSessionMicLevelsMode;

package/dist/components/TranscriptStudioChrome.d.ts

@@ -1,10 +1,14 @@
+import * as React from 'react';
 import type { TranscriptPanelMode, TranscriptSessionMode } from '../types/GuideAI.types';
 import type { StubWorkspaceOption } from '../stubs/workspaces';
 export interface TranscriptStudioChromeProps {
-    /** First segment of the breadcrumb (workspace display name for the host). */
+    /** Current workspace label from catalog (shown when workspace picker is not a menu). */
     workspaceBreadcrumbLabel: string;
-    /** Second segment: workflow name shown beside the workspace. */
+    /** Active workflow step title (breadcrumb; opens workflow drawer). */
     workflowStepLabel: string;
+    workspaceOptions: StubWorkspaceOption[];
+    transcriptSessionMode: TranscriptSessionMode;
+    onWorkspaceChange: (mode: TranscriptSessionMode) => void;
     progressCurrent: number;
     progressTotal: number;
     /** 0-based index of the highlighted workflow step (drives segment styling). */
@@ -15,17 +19,14 @@ export interface TranscriptStudioChromeProps {
     transcriptPanelMode: TranscriptPanelMode;
     onToggleTranscriptPanelMode: () => void;
     onEndSession: () => void;
-    workspaceOptions: StubWorkspaceOption[];
-    transcriptSessionMode: TranscriptSessionMode;
-    onWorkspaceChange: (mode: TranscriptSessionMode) => void;
     React: typeof import('react');
-    /** Host `ReactDOM.createPortal` — enables portaled workspace menu above clipped chrome. */
+    /** Host `ReactDOM.createPortal` — menus port above the clipped float toolbar. */
     ReactDOM?: {
         createPortal: (children: import('react').ReactNode, container: Element) => import('react').ReactNode;
     };
 }
 declare const TranscriptStudioChrome: {
-    ({ workspaceBreadcrumbLabel, workflowStepLabel, progressCurrent, progressTotal, activeStepIndex, allWorkflowStepsComplete, workflowDrawerOpen, onToggleWorkflowDrawer, transcriptPanelMode, onToggleTranscriptPanelMode, onEndSession, workspaceOptions, transcriptSessionMode, onWorkspaceChange, React, ReactDOM, }: TranscriptStudioChromeProps): import("react").JSX.Element;
+    ({ workspaceBreadcrumbLabel, workflowStepLabel, workspaceOptions, transcriptSessionMode, onWorkspaceChange, progressCurrent, progressTotal, activeStepIndex, allWorkflowStepsComplete, workflowDrawerOpen, onToggleWorkflowDrawer, transcriptPanelMode, onToggleTranscriptPanelMode, onEndSession, React, ReactDOM, }: TranscriptStudioChromeProps): React.JSX.Element;
     displayName: string;
 };
 export default TranscriptStudioChrome;

package/dist/components/TranscriptTextInput.d.ts

@@ -1,7 +1,6 @@
-import React from 'react';
 import type { RecordingStatus, TranscriptPanelMode, TranscriptSessionMode } from '../types/GuideAI.types';
 import type { StubWorkspaceOption } from '../stubs/workspaces';
-import { type WorkspaceDataSource } from '../utils/localStorageHelper';
+import type { TranscriptDevtoolsMenuProps } from '../devtools/transcriptDevtoolsMenuProps';
 import type { MicPresetId } from '../types/audioConfig.types';
 interface TranscriptTextInputProps {
     textInput?: string;
@@ -23,20 +22,13 @@ interface TranscriptTextInputProps {
     isAssistantPlaybackMuted?: boolean;
     onToggleAssistantPlaybackMute?: () => void;
     handleResetChat?: () => void;
-    /** GuideAI.debug.showMoreMenu() in console */
-    debugMoreMenuEnabled?: boolean;
-    /** Transcript ⋯ → Debug: unified developer tools */
-    developerToolsMenu?: {
-        shellOpen: boolean;
-        onToggleShell: () => void;
-    } | null;
+    /** Transcript ⋯ developer tools menu (admin / developer access). */
+    transcriptDevtools?: TranscriptDevtoolsMenuProps;
     /** User mic preset shown in ⋯ menu. */
     micPreset?: MicPresetId;
     /** Apply mic preset (persists + updates session config). */
     onApplyMicPreset?: (preset: MicPresetId) => void;
     workspaceOptions: StubWorkspaceOption[];
-    /** Debug ⋯: stub vs API workspace source (toggle writes localStorage). */
-    workspaceDataSource: WorkspaceDataSource;
     /**
      * `docked` (DockedPanel): textarea auto-grows. `float` (FloatPanel): input chrome height is fixed so
      * the workflow sheet does not change footer layout.
@@ -47,5 +39,5 @@ interface TranscriptTextInputProps {
     };
     React: typeof import('react');
 }
-declare const TranscriptTextInput: ({ textInput, setTextInput, handleTextSubmit, handleTextKeyPress, textPlaceholder: _textPlaceholder, connectionMessage, isDataChannelOpen, isResponseActive, sessionMode, onSessionModeChange, recordingStatus, isConnecting, hasMic, isMuted, handleToggleMute, isAssistantPlaybackMuted, onToggleAssistantPlaybackMute, handleResetChat, debugMoreMenuEnabled, developerToolsMenu, micPreset, onApplyMicPreset, workspaceOptions, workspaceDataSource, transcriptPanelMode, ReactDOM, React, }: TranscriptTextInputProps) => React.JSX.Element;
+declare const TranscriptTextInput: ({ textInput, setTextInput, handleTextSubmit, handleTextKeyPress, textPlaceholder: _textPlaceholder, connectionMessage, isDataChannelOpen, isResponseActive, sessionMode, onSessionModeChange, recordingStatus, isConnecting, hasMic, isMuted, handleToggleMute, isAssistantPlaybackMuted, onToggleAssistantPlaybackMute, handleResetChat, transcriptDevtools, micPreset, onApplyMicPreset, workspaceOptions, transcriptPanelMode, ReactDOM, React, }: TranscriptTextInputProps) => import("react").JSX.Element;
 export default TranscriptTextInput;

package/dist/components/TranscriptToolbar.d.ts

@@ -14,10 +14,12 @@ interface TranscriptToolbarProps {
     onEndSession: () => void;
     transcriptPanelMode: TranscriptPanelMode;
     onToggleTranscriptPanelMode: () => void;
+    /** Embed only: triple-click workflow title to reveal Developer login in ⋯. */
+    onDevtoolsToolbarTitleClick?: () => void;
     React: typeof import('react');
 }
 declare const TranscriptToolbar: {
-    ({ workflowChecklistEnabled, workflowCheckedCount, workflowTotalCount, displayWorkflowTitle, workflowDrawerOpen, onToggleWorkflowDrawer, onEndSession, transcriptPanelMode, onToggleTranscriptPanelMode, React, }: TranscriptToolbarProps): import("react").JSX.Element;
+    ({ workflowChecklistEnabled, workflowCheckedCount, workflowTotalCount, displayWorkflowTitle, workflowDrawerOpen, onToggleWorkflowDrawer, onEndSession, transcriptPanelMode, onToggleTranscriptPanelMode, onDevtoolsToolbarTitleClick, React, }: TranscriptToolbarProps): import("react").JSX.Element;
     displayName: string;
 };
 export default TranscriptToolbar;

package/dist/components/TranscriptWorkflowDrawer.d.ts

@@ -1,5 +1,6 @@
 import type { TranscriptPanelMode } from '../types/GuideAI.types';
 import type { StubWorkflowItem } from '../stubs/workspaces';
+import type { TranscriptWorkflowStripGestureHandlers } from '../hooks/useTranscriptPanelDragResize';
 interface TranscriptWorkflowDrawerProps {
     open: boolean;
     onOpenChange: (open: boolean) => void;
@@ -24,16 +25,13 @@ interface TranscriptWorkflowDrawerProps {
     workspaceDescription: string;
     workspaceIcon: string;
     /** Float card only: tap toggles workflow; drag starts parent float-pan (replaces vertical strip drag). */
-    floatStripGestureHandlers?: {
-        onPointerDown: (e: import('react').PointerEvent<HTMLButtonElement>) => void;
-        onPointerMove: (e: import('react').PointerEvent<HTMLButtonElement>) => void;
-        onPointerUp: (e: import('react').PointerEvent<HTMLButtonElement>) => void;
-        onPointerCancel: (e: import('react').PointerEvent<HTMLButtonElement>) => void;
-    };
+    floatStripGestureHandlers?: TranscriptWorkflowStripGestureHandlers;
+    /** Docked panel only: tap toggles workflow; drag left undocks to float (replaces vertical strip drag). */
+    dockStripGestureHandlers?: TranscriptWorkflowStripGestureHandlers;
     React: typeof import('react');
 }
 declare const TranscriptWorkflowDrawer: {
-    ({ open, onOpenChange, transcriptPanelMode, toolbar, workflowChecked, onToggleWorkflowCheck, workflowChecklistEnabled, workflowConfettiEnabled, onWorkflowActivate, highlightedWorkflowId, workflows, workspaceTitle, workspaceDescription, workspaceIcon, floatStripGestureHandlers, React, }: TranscriptWorkflowDrawerProps): import("react").JSX.Element;
+    ({ open, onOpenChange, transcriptPanelMode, toolbar, workflowChecked, onToggleWorkflowCheck, workflowChecklistEnabled, workflowConfettiEnabled, onWorkflowActivate, highlightedWorkflowId, workflows, workspaceTitle, workspaceDescription, workspaceIcon, floatStripGestureHandlers, dockStripGestureHandlers, React, }: TranscriptWorkflowDrawerProps): import("react").JSX.Element;
     displayName: string;
 };
 export default TranscriptWorkflowDrawer;

package/dist/contexts/GuideAIThemeContext.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { GuideAIThemeId } from '../themes/guideAIThemeIds';
+export type GuideAIThemeContextValue = {
+    activeThemeId: GuideAIThemeId | null;
+    /** Devtools-only: set preset (saved in localStorage) or package default. */
+    setThemeId: (id: GuideAIThemeId | 'default') => void;
+};
+export declare function GuideAIThemeContextProvider({ value, children, }: {
+    value: GuideAIThemeContextValue;
+    children: React.ReactNode;
+}): React.JSX.Element;
+export declare function useGuideAITheme(): GuideAIThemeContextValue;
+export declare function useGuideAIThemeOptional(): GuideAIThemeContextValue | null;

package/dist/devtools/DeveloperToolsShell.d.ts

@@ -17,4 +17,4 @@ export interface DeveloperToolsShellProps {
 /**
  * Single floating shell: full-height icon rail (left), header + tool body (right).
  */
-export declare function DeveloperToolsShell({ React: R, ReactDOM, zIndex, open, activeTab, onActiveTabChange, onClose, tabs, children, }: DeveloperToolsShellProps): string | number | boolean | React.JSX.Element | Iterable<React.ReactNode> | null | undefined;
+export declare function DeveloperToolsShell({ React: R, ReactDOM, zIndex, open, activeTab, onActiveTabChange, onClose, tabs, children, }: DeveloperToolsShellProps): string | number | boolean | Iterable<React.ReactNode> | React.JSX.Element | null | undefined;

package/dist/devtools/TranscriptDeveloperToolsMenuItems.d.ts

@@ -0,0 +1,45 @@
+import React from 'react';
+import type { GuideAIEnvironment } from '../types/GuideAI.types';
+import type { DeveloperToolsShellControl } from './transcriptDevtoolsMenuProps';
+export type TranscriptDeveloperToolsMoreMenuItemsProps = {
+    sectionVisible: boolean;
+    shellControl: DeveloperToolsShellControl;
+    loginVisible: boolean;
+    onOpenLogin: () => void;
+    showLogout: boolean;
+    onLogout: () => void;
+    onCloseMenu: () => void;
+    debugFlyout: null | 'logger' | 'micPreset' | 'adminPortal';
+    setDebugFlyout: React.Dispatch<React.SetStateAction<null | 'logger' | 'micPreset' | 'adminPortal'>>;
+    loggerFlyoutTriggerRef: React.RefObject<HTMLButtonElement>;
+    adminPortalFlyoutTriggerRef: React.RefObject<HTMLButtonElement>;
+    getServerConversationId?: () => string | null;
+    onOpenTranscriptUiSettings?: () => void;
+};
+/** Developer login + Developer tools rows in transcript ⋯. */
+export declare function TranscriptDeveloperToolsMoreMenuItems({ sectionVisible, shellControl, loginVisible, onOpenLogin, showLogout, onLogout, onCloseMenu, debugFlyout, setDebugFlyout, loggerFlyoutTriggerRef, adminPortalFlyoutTriggerRef, getServerConversationId, onOpenTranscriptUiSettings, }: TranscriptDeveloperToolsMoreMenuItemsProps): React.JSX.Element;
+export type DeveloperToolsLoggerFlyoutProps = {
+    open: boolean;
+    flyoutStyle: React.CSSProperties | null;
+    usePortal: boolean;
+    ReactDOM?: {
+        createPortal: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
+    listRef: React.RefObject<HTMLUListElement>;
+};
+/** Portaled Console debugger submenu (⋯ → Developer tools). */
+export declare function DeveloperToolsLoggerFlyout({ open, flyoutStyle, usePortal, ReactDOM, listRef, }: DeveloperToolsLoggerFlyoutProps): React.ReactNode;
+export type DeveloperToolsAdminPortalFlyoutProps = {
+    open: boolean;
+    flyoutStyle: React.CSSProperties | null;
+    usePortal: boolean;
+    ReactDOM?: {
+        createPortal: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
+    listRef: React.RefObject<HTMLUListElement>;
+    getServerConversationId: () => string | null;
+    widgetEnvironment?: GuideAIEnvironment;
+    onCloseMenu: () => void;
+};
+/** Portaled Open in admin submenu (⋯ → Developer tools). */
+export declare function DeveloperToolsAdminPortalFlyout({ open, flyoutStyle, usePortal, ReactDOM, listRef, getServerConversationId, widgetEnvironment, onCloseMenu, }: DeveloperToolsAdminPortalFlyoutProps): React.ReactNode;

package/dist/devtools/TranscriptUiDevtoolsPanel.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { TranscriptDisplayMode } from '../types/GuideAI.types';
+export type TranscriptUiDevtoolsPanelProps = {
+    transcriptDisplayMode: TranscriptDisplayMode;
+    onTranscriptDisplayModeChange: (mode: TranscriptDisplayMode) => void;
+    subtitleDarkHighlight: boolean;
+    onSubtitleDarkHighlightChange: (enabled: boolean) => void;
+};
+/** Developer tools → Transcript UI tab. */
+export declare function TranscriptUiDevtoolsPanel({ transcriptDisplayMode, onTranscriptDisplayModeChange, subtitleDarkHighlight, onSubtitleDarkHighlightChange, }: TranscriptUiDevtoolsPanelProps): React.JSX.Element;

package/dist/devtools/adminToolDiagnostics/AdminToolDiagnosticsPanel.d.ts

@@ -20,4 +20,4 @@ export interface AdminToolDiagnosticsPanelProps {
      */
     devtoolsShellZIndex?: number;
 }
-export declare const AdminToolDiagnosticsPanel: ({ React: R, ReactDOM, runTool, getToolNames, getSampleArgsJsonForToolName, onClose, embedded, devtoolsShellZIndex, }: AdminToolDiagnosticsPanelProps) => string | number | boolean | React.JSX.Element | Iterable<React.ReactNode> | null | undefined;
+export declare const AdminToolDiagnosticsPanel: ({ React: R, ReactDOM, runTool, getToolNames, getSampleArgsJsonForToolName, onClose, embedded, devtoolsShellZIndex, }: AdminToolDiagnosticsPanelProps) => string | number | boolean | Iterable<React.ReactNode> | React.JSX.Element | null | undefined;

package/dist/devtools/developerToolPanelId.d.ts

@@ -1,5 +1,5 @@
 /** Tabs inside the unified transcript Debug → Developer tools shell. */
-export type DeveloperToolPanelId = 'audio' | 'playbackLock' | 'visualContext' | 'toolDiagnostics' | 'workflowTester';
+export type DeveloperToolPanelId = 'audio' | 'playbackLock' | 'visualContext' | 'toolDiagnostics' | 'learn' | 'workflowTester';
 /**
  * Single source for shell rail order and title `<select>` options (when visual context is on).
  * {@link useGuideDeveloperTools} filters out `visualContext` when the feature is disabled.

package/dist/devtools/devtoolsAdminPortalLinks.d.ts

@@ -0,0 +1,11 @@
+import type { GuideAIEnvironment } from '../types/GuideAI.types';
+export type DevtoolsAdminPortalLinkTargets = {
+    conversationId: string | null;
+    workflowId: string | null;
+};
+export type DevtoolsAdminPortalUrls = {
+    conversation: string | null;
+    workflow: string | null;
+};
+export declare function getDevtoolsAdminSiteOrigin(environment?: GuideAIEnvironment): string | null;
+export declare function buildDevtoolsAdminPortalUrls(origin: string | null, targets: DevtoolsAdminPortalLinkTargets): DevtoolsAdminPortalUrls;

package/dist/devtools/devtoolsAuth/DevtoolsAuthContext.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { DevtoolsPortalSession } from './types';
+export type DevtoolsAuthContextValue = {
+    portalToken: string | null;
+    portalUser: DevtoolsPortalSession['user'] | null;
+    isAdministrator: boolean;
+};
+export type DevtoolsAuthProviderProps = {
+    value: DevtoolsAuthContextValue;
+    children: React.ReactNode;
+};
+export declare function DevtoolsAuthProvider({ value, children }: DevtoolsAuthProviderProps): React.JSX.Element;
+/** Portal JWT + user for developer-tools admin API calls. Null when outside the provider. */
+export declare function useDevtoolsAuth(): DevtoolsAuthContextValue | null;

package/dist/devtools/devtoolsAuth/DevtoolsLoginModal.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { GuideAIEnvironment } from '../../types/GuideAI.types';
+export type DevtoolsLoginModalProps = {
+    React: typeof import('react');
+    ReactDOM?: {
+        createPortal: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
+    open: boolean;
+    environment?: GuideAIEnvironment;
+    onClose: () => void;
+    onSuccess: () => void;
+};
+export declare function DevtoolsLoginModal({ React: ReactRuntime, ReactDOM, open, environment, onClose, onSuccess, }: DevtoolsLoginModalProps): string | number | boolean | Iterable<React.ReactNode> | React.JSX.Element | null | undefined;

package/dist/devtools/devtoolsAuth/devtoolsAccessTrigger.d.ts

@@ -0,0 +1,9 @@
+/** Hidden chord: Ctrl/Cmd + Shift + Alt + D (physical D key). */
+export declare function isDevtoolsAccessKeyboardShortcut(event: KeyboardEvent): boolean;
+/**
+ * Counts rapid presses on the embed unlock target (toolbar workflow title).
+ * Uses {@link TRIPLE_CLICK_MS} between first and third press.
+ */
+export declare function createTripleClickDetector(onTripleClick: () => void): () => void;
+/** Attach embed unlock keyboard chord on `document` (capture) so it works inside shadow DOM / iframes. */
+export declare function attachDevtoolsAccessKeyboardListener(onMatch: () => void): () => void;

package/dist/devtools/devtoolsAuth/devtoolsAdminApi.d.ts

@@ -0,0 +1,13 @@
+import type { GuideAIEnvironment } from '../../types/GuideAI.types';
+export type DevtoolsAdminFetchOptions = {
+    token: string;
+    environment?: GuideAIEnvironment;
+    method?: string;
+    body?: unknown;
+    headers?: Record<string, string>;
+};
+/**
+ * Authenticated fetch for extension-scoped admin APIs. Paths are relative to {@link getApiBaseUrl}
+ * (which already ends with `/api`), e.g. `/extension/admin/...` — not `/api/extension/...`.
+ */
+export declare function devtoolsAdminFetch(path: string, options: DevtoolsAdminFetchOptions): Promise<Response>;

package/dist/devtools/devtoolsAuth/devtoolsLoginModalStyles.d.ts

@@ -0,0 +1 @@
+export declare function devtoolsLoginModalStyles(): string;

package/dist/devtools/devtoolsAuth/devtoolsPortalLogin.d.ts

@@ -0,0 +1,15 @@
+import type { GuideAIEnvironment } from '../../types/GuideAI.types';
+import type { DevtoolsPortalSession } from './types';
+export declare class DevtoolsPortalLoginError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+/**
+ * Authenticate an administrator against the GuideAI portal (Cognito + AuthUser).
+ * Only `ADMINISTRATOR` role may unlock developer tools.
+ */
+export declare function loginDevtoolsPortal(input: {
+    environment?: GuideAIEnvironment;
+    email: string;
+    password: string;
+}): Promise<DevtoolsPortalSession>;

package/dist/devtools/devtoolsAuth/devtoolsSessionStorage.d.ts

@@ -0,0 +1,4 @@
+import type { DevtoolsPortalSession } from './types';
+export declare function readStoredDevtoolsPortalSession(): DevtoolsPortalSession | null;
+export declare function writeStoredDevtoolsPortalSession(session: DevtoolsPortalSession): void;
+export declare function clearStoredDevtoolsPortalSession(): void;

package/dist/devtools/devtoolsAuth/index.d.ts

@@ -0,0 +1,9 @@
+export type { DevtoolsPortalSession, DevtoolsPortalUser, ExtensionPortalAuthProp } from './types';
+export { isDevtoolsAdministrator } from './types';
+export { loginDevtoolsPortal, DevtoolsPortalLoginError } from './devtoolsPortalLogin';
+export { readStoredDevtoolsPortalSession, writeStoredDevtoolsPortalSession, clearStoredDevtoolsPortalSession, } from './devtoolsSessionStorage';
+export { devtoolsAdminFetch, type DevtoolsAdminFetchOptions } from './devtoolsAdminApi';
+export { isDevtoolsAccessKeyboardShortcut, createTripleClickDetector, attachDevtoolsAccessKeyboardListener, } from './devtoolsAccessTrigger';
+export { DevtoolsLoginModal } from './DevtoolsLoginModal';
+export { devtoolsLoginModalStyles } from './devtoolsLoginModalStyles';
+export { useDevtoolsAccess, type DevtoolsAccessState, type UseDevtoolsAccessParams, } from './useDevtoolsAccess';

package/dist/devtools/devtoolsAuth/types.d.ts

@@ -0,0 +1,21 @@
+/** Portal user snapshot returned by `POST /extension/auth/login`. */
+export type DevtoolsPortalUser = {
+    id: string;
+    email: string;
+    username: string;
+    role: string;
+    customerId: string | null;
+};
+/** Authenticated administrator session for developer tools (extension portal JWT). */
+export type DevtoolsPortalSession = {
+    token: string;
+    user: DevtoolsPortalUser;
+    expiresAt: string;
+    /** `extension` = popup sign-in; `modal` = in-widget admin login. */
+    source: 'extension' | 'modal';
+};
+export type ExtensionPortalAuthProp = {
+    token: string;
+    user: DevtoolsPortalUser;
+} | null;
+export declare function isDevtoolsAdministrator(user: Pick<DevtoolsPortalUser, 'role'> | null | undefined): boolean;

package/dist/devtools/devtoolsAuth/useDevtoolsAccess.d.ts

@@ -0,0 +1,33 @@
+import React from 'react';
+import type { ReactHooks } from '../../utils/reactHooks';
+import type { GuideAIEnvironment } from '../../types/GuideAI.types';
+import type { DevtoolsPortalSession, ExtensionPortalAuthProp } from './types';
+export type UseDevtoolsAccessParams = {
+    hooks: ReactHooks;
+    React: typeof import('react');
+    ReactDOM?: {
+        createPortal: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
+    environment?: GuideAIEnvironment;
+    /** Chrome extension popup sign-in (includes portal JWT when connected). */
+    extensionPortalAuth?: ExtensionPortalAuthProp;
+};
+export type DevtoolsAccessState = {
+    /** Full Developer tools section in transcript ⋯ (extension admin or embed after admin login). */
+    showDeveloperToolsMenu: boolean;
+    /** Embed only: hidden unlock revealed the Developer login row (not yet signed in). */
+    showDevtoolsLoginItem: boolean;
+    openDevtoolsLogin: () => void;
+    /** Embed only: triple-click transcript workflow title. No-op in extension. */
+    onTranscriptToolbarTitleClick: () => void;
+    /** Embed only: hidden unlock reveals the Developer login row in ⋯. */
+    revealEmbedDeveloperLogin: () => void;
+    revokeEmbedDeveloperAccess: () => void;
+    logoutDeveloper: () => void;
+    /** Embed with modal admin session: show Logout developer in Debug ⋯. */
+    showDeveloperLogout: boolean;
+    portalToken: string | null;
+    portalUser: DevtoolsPortalSession['user'] | null;
+    loginModal: React.ReactNode;
+};
+export declare function useDevtoolsAccess({ hooks, React, ReactDOM, environment, extensionPortalAuth, }: UseDevtoolsAccessParams): DevtoolsAccessState;

package/dist/devtools/devtoolsThemePreference.d.ts

@@ -0,0 +1,3 @@
+import { type GuideAIThemeId } from '../themes/guideAIThemeIds';
+export declare function readDevtoolsThemePreference(): GuideAIThemeId | null;
+export declare function writeDevtoolsThemePreference(themeId: GuideAIThemeId | null): void;

package/dist/devtools/excavator/ExcavatorPanel.d.ts

@@ -0,0 +1,17 @@
+/**
+ * GuideAI Excavator — developer tool: browser automation + copilot via the **same Guide AI API base**
+ * as the widget (`GET/POST …/api/excavator/…`), or **`excavatorApiBaseUrl`** when the host serves
+ * Excavator on a different origin than the widget session. The host implements those routes or proxies
+ * Playwright companion; no separate companion URL in the UI.
+ *
+ * Visual structure matches other dev tools (`guideai-atd-*`). Nested in {@link DeveloperToolsShell}.
+ */
+import React from 'react';
+export interface ExcavatorPanelProps {
+    zIndex: number;
+    visible: boolean;
+    onClose: () => void;
+    embedded?: boolean;
+}
+declare const ExcavatorPanel: ({ zIndex, visible, onClose, embedded }: ExcavatorPanelProps) => React.JSX.Element | null;
+export default ExcavatorPanel;

package/dist/devtools/excavator/excavatorPanelStyles.d.ts

@@ -0,0 +1,5 @@
+/**
+ * GuideAI Excavator — scoped additions to shared `guideai-atd-*` devtools look
+ * (see {@link adminToolDiagnosticsStyles}).
+ */
+export declare const excavatorPanelStyles: () => string;