guideai-app 0.5.1 → 0.5.4-1

package/dist/__mocks__/fileMock.d.ts

@@ -0,0 +1,2 @@
+declare const _exports: string;
+export = _exports;

package/dist/components/AudioConfigDialog.d.ts

@@ -0,0 +1,22 @@
+import { AudioConfig, StoredAudioConfig, type MicPresetId } from '../types/audioConfig.types';
+interface AudioConfigDialogProps {
+    isOpen: boolean;
+    onClose: () => void;
+    initialConfig: StoredAudioConfig | null;
+    onApply: (config: AudioConfig, stored: StoredAudioConfig) => void;
+    /** Fire-and-forget server log when mic preset dropdown changes (same style as mute debug logs). */
+    onMicPresetApplied?: (preset: MicPresetId) => void;
+    hasRespondedWithAudio: boolean;
+    defaultMicLabel: string | null;
+    React: typeof import('react');
+    ReactDOM?: {
+        createPortal: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
+}
+declare const AudioConfigDialog: {
+    ({ isOpen, onClose, initialConfig, onApply, onMicPresetApplied, hasRespondedWithAudio, defaultMicLabel, React, ReactDOM, }: AudioConfigDialogProps): import("react").FunctionComponentElement<{
+        children?: import("react").ReactNode | undefined;
+    }> | null;
+    displayName: string;
+};
+export default AudioConfigDialog;

package/dist/components/DeveloperTools.d.ts

@@ -0,0 +1,36 @@
+import React from 'react';
+import { type DataChannelManager } from '../utils/dataChannel';
+import { type VisualContextInspectorProps } from '../devtools/visualContextInspector';
+import { type PlaybackLockDebugOverlayRootProps } from './PlaybackLockDebugOverlayRoot';
+import AudioConfigDialog from './AudioConfigDialog';
+type AudioConfigForDeveloperTools = Omit<React.ComponentProps<typeof AudioConfigDialog>, 'React' | 'ReactDOM'>;
+type VisualContextForDeveloperTools = {
+    show: boolean;
+} & Omit<VisualContextInspectorProps, 'React' | 'ReactDOM' | 'bufferThresholdBytes'>;
+type ToolDiagnosticsForDeveloperTools = {
+    /** @see DataChannelManager — not the WebRTC `RTCDataChannel` from `DataChannelManager#getDataChannel()`. */
+    getDataChannelManager: () => DataChannelManager | null;
+    propToolNames: string[];
+    debugMoreMenu: boolean;
+    toolPanelOpen: boolean;
+    onCloseToolPanel: () => void;
+};
+type DeveloperToolsProps = {
+    React: typeof import('react');
+    ReactDOM?: {
+        createPortal: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
+    toolDiagnostics: ToolDiagnosticsForDeveloperTools;
+    playbackLock: PlaybackLockDebugOverlayRootProps;
+    audioConfig: AudioConfigForDeveloperTools;
+    visualContext: VisualContextForDeveloperTools;
+};
+/**
+ * Debug / developer-only **floating** UI: playback-lock overlay, audio config, visual
+ * context inspector, and tool diagnostics. Opened from the transcript ⋯ “more” menu
+ * and related entry points. Does **not** wrap the main Guide shell — mount as a
+ * sibling to mic + transcript; pair with `AdminToolDiagnosticsContext.Provider` in
+ * `GuideAI` so the transcript menu can toggle the tool panel.
+ */
+export declare function DeveloperTools({ React: R, ReactDOM, toolDiagnostics: { getDataChannelManager, propToolNames, debugMoreMenu, toolPanelOpen, onCloseToolPanel, }, playbackLock, audioConfig, visualContext, }: DeveloperToolsProps): React.JSX.Element;
+export {};

package/dist/components/MicGlyphs.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+/** Shared mic SVGs for mute UI in the transcript footer and more menu. */
+export declare function MicGlyphMuted({ className }: {
+    className?: string;
+}): React.JSX.Element;
+/** Same body shape as muted glyph, without slash (352×512 space). */
+export declare function MicGlyphUnmuted({ className }: {
+    className?: string;
+}): React.JSX.Element;

package/dist/components/Microphone.d.ts

@@ -2,18 +2,20 @@ import { PopupPosition, RecordingStatus } from '../types/GuideAI.types';
 interface MicrophoneProps {
     componentRef: React.RefObject<HTMLDivElement>;
     baseStyles: React.CSSProperties;
-    hasInteracted: boolean;
     popupPosition: PopupPosition;
     showOnboarding: boolean;
     handleOnboardingComplete: () => void;
     handleOnboardingClose: () => void;
     isConnecting: boolean;
+    connectionMessage?: string | null;
     status: RecordingStatus;
     handleToggleConversation: () => void;
     showTranscript: boolean;
     hasMic: boolean;
     isMuted: boolean;
+    /** Persisted flag: drives pre (`false`) vs post (`true`) interaction prompt pool and presentation. */
+    hasInteracted: boolean;
     React: typeof import('react');
 }
-declare const Microphone: ({ componentRef, baseStyles, hasInteracted, popupPosition, showOnboarding, handleOnboardingComplete, handleOnboardingClose, isConnecting, status, handleToggleConversation, showTranscript, hasMic, isMuted, React, }: MicrophoneProps) => import("react").JSX.Element;
+declare const Microphone: ({ componentRef, baseStyles, popupPosition, showOnboarding, handleOnboardingComplete, handleOnboardingClose, isConnecting, connectionMessage, status, handleToggleConversation, showTranscript, hasMic, isMuted, hasInteracted, React, }: MicrophoneProps) => import("react").JSX.Element;
 export default Microphone;

package/dist/components/NoisyPresetSuggestBanner.d.ts

@@ -0,0 +1,12 @@
+/**
+ * One-shot prompt: Precise preset users who barge in during assistant playback may want Noisy preset.
+ */
+import React from 'react';
+export interface NoisyPresetSuggestBannerProps {
+    visible: boolean;
+    onYes: () => void;
+    onNo: () => void;
+    onAutoDismiss?: () => void;
+}
+declare const NoisyPresetSuggestBanner: ({ visible, onYes, onNo, onAutoDismiss, }: NoisyPresetSuggestBannerProps) => React.JSX.Element | null;
+export default NoisyPresetSuggestBanner;

package/dist/components/PlaybackInterruptLockDebugOverlay.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Debug UI: microphone preset and system "interrupt lock" / effective VAD state.
+ * Shown from transcript ⋯ → Debug → Show playback lock debug (default off); close button or menu hides it.
+ */
+import React from 'react';
+export interface PlaybackInterruptLockDebugOverlayProps {
+    preset: 'precise' | 'noisy';
+    lockActive: boolean;
+    lockMode: 'none' | 'system_interrupt_lock';
+    vadType: 'server_vad' | 'semantic_vad' | 'off';
+    threshold?: number;
+    interruptResponse?: boolean;
+    /** User started speaking while assistant output buffer was active (debug signal). */
+    interruptDetected?: boolean;
+    zIndex: number;
+    onClose?: () => void;
+}
+declare const PlaybackInterruptLockDebugOverlay: ({ preset, lockActive, lockMode, vadType, threshold, interruptResponse, interruptDetected, zIndex, onClose, }: PlaybackInterruptLockDebugOverlayProps) => React.JSX.Element;
+export default PlaybackInterruptLockDebugOverlay;

package/dist/components/PlaybackLockDebugOverlayRoot.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { MicPresetId } from '../types/audioConfig.types';
+import type { InterruptLockOverlayConfig } from '../hooks/useProtectedPlayback';
+export interface PlaybackLockDebugOverlayRootProps {
+    zIndex: number;
+    visible: boolean;
+    onClose: () => void;
+    micPreset: MicPresetId;
+    protectedPlaybackActive: boolean;
+    overlayConfig: InterruptLockOverlayConfig;
+    playbackInterruptDebug: boolean;
+}
+/** Wires `useProtectedPlayback` + `usePlaybackLockDebugOverlay` into `PlaybackInterruptLockDebugOverlay`. */
+export declare function PlaybackLockDebugOverlayRoot({ zIndex, visible, onClose, micPreset, protectedPlaybackActive, overlayConfig, playbackInterruptDebug, }: PlaybackLockDebugOverlayRootProps): React.JSX.Element | null;

package/dist/components/ResetGlyph.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+/** Stroke-based reset / refresh arrow; reads clearly at small sizes (unlike the legacy filled reset.svg). */
+export declare function ResetGlyph({ className }: {
+    className?: string;
+}): React.JSX.Element;

package/dist/components/SpeakerGlyphs.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+/** Speaker + sound waves — assistant audio on (mono styling applied via CSS on parent). */
+export declare function SpeakerGlyphUnmuted({ className }: {
+    className?: string;
+}): React.JSX.Element;
+/** Speaker with X — assistant audio muted (accent lines match muted mic). */
+export declare function SpeakerGlyphMuted({ className }: {
+    className?: string;
+}): React.JSX.Element;

package/dist/components/TranscriptBox.d.ts

@@ -1,32 +1,89 @@
 import { StoredMessage } from '../utils/messageStorage';
-import { TranscriptPosition, MicButtonPosition } from '../types/GuideAI.types';
+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 { MarkWorkflowCompleteFn } from '../utils/tools/workflowToolBridge';
+import type { MicPresetId } from '../types/audioConfig.types';
 interface TranscriptBoxProps {
     allMessages: StoredMessage[];
     showTranscript: boolean;
-    handleCloseTranscript: () => void;
-    showToggleButton?: boolean;
-    handleToggleTranscript?: () => void;
+    fileDropTargetActive?: boolean;
+    transcriptFileDropAllowed?: boolean;
+    docFormProgress?: 'off' | 'extracting' | 'filling';
+    /** Drop a file on the transcript card to run docToForm extraction (wired in GuideAI). */
+    onTranscriptFileDrop?: (file: File) => void;
+    /** Tear down WebRTC, clear session, return to mic — toolbar X only (footer status control toggles mute). */
+    onEndSession?: () => void;
+    recordingStatus?: RecordingStatus;
+    isConnecting?: boolean;
     showTextInput?: boolean;
     textInput?: string;
     setTextInput?: (value: string) => void;
     handleTextSubmit?: () => void;
     handleTextKeyPress?: (event: React.KeyboardEvent) => void;
     textPlaceholder?: string;
+    /** Connection status message (e.g. "Initializing...", "Retrying...") */
+    connectionMessage?: string | null;
     micPosition?: MicButtonPosition;
     transcriptPosition: TranscriptPosition;
     hasMic: boolean;
     isMuted?: boolean;
     handleToggleMute?: () => void;
-    isConversationActive?: boolean;
+    /** Mute assistant (TTS) playback — separate from microphone mute. */
+    isAssistantPlaybackMuted?: boolean;
+    onToggleAssistantPlaybackMute?: () => void;
     handleResetChat?: () => void;
-    showSettings?: boolean;
-    setShowSettings?: (value: boolean) => void;
     isDataChannelOpen?: boolean;
     isResponseActive?: boolean;
+    onOpenConfig?: () => void;
+    /** Console: GuideAI.debug.showMoreMenu() — extra ⋯ menu rows for developers. */
+    debugMoreMenuEnabled?: boolean;
+    /** Transcript ⋯ → Debug: fixed playback interrupt lock panel visibility. */
+    playbackLockDebugOverlayVisible?: boolean;
+    onTogglePlaybackLockDebugOverlay?: () => void;
+    /** Current mic preset (Precise / Noisy); shown in ⋯ flyout when debug menu is on. */
+    micPreset?: MicPresetId;
+    /** Apply preset from transcript menu: persist, reset stored audio to preset base, live session.update. */
+    onApplyMicPreset?: (preset: MicPresetId) => void;
+    noisyPresetSuggestVisible?: boolean;
+    onNoisyPresetSuggestYes?: () => void;
+    onNoisyPresetSuggestNo?: () => void;
+    onNoisyPresetSuggestAutoDismiss?: () => void;
+    /** False when visual context is disabled via props (hides related debug actions). */
+    visualContextFeatureEnabled?: boolean;
+    /**
+     * **DockedPanel** (`docked`) vs **FloatPanel** (`float`). Not the workflow steps drawer
+     * (`workflowDrawerOpen`).
+     */
+    transcriptPanelMode?: TranscriptPanelMode;
+    onToggleTranscriptPanelMode?: () => void;
+    transcriptSessionMode?: TranscriptSessionMode;
+    onTranscriptSessionModeChange?: (mode: TranscriptSessionMode) => void;
+    /** Stub list until API-driven; computed once in GuideAI. */
+    workspaceOptions: StubWorkspaceOption[];
+    /** Debug: stub vs API workspace data (API has no fetch yet — empty workflows). */
+    workspaceDataSource: WorkspaceDataSource;
+    /** Workflow steps for the current workspace; from stubs or future API. */
+    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;
+    /** Parent-owned ref; `markWorkflowComplete` tool delegates here (wired in GuideAI). */
+    markWorkflowCompleteHandlerRef: {
+        current: MarkWorkflowCompleteFn | null;
+    };
+    /** Docked drawer width (px); persisted by parent when `onDrawerWidthChange` is used. */
+    drawerWidthPx?: number;
+    onDrawerWidthChange?: (widthPx: number) => void;
     React: typeof import('react');
+    /** Host ReactDOM.createPortal — required for workspace menu above clipped transcript card */
+    ReactDOM?: {
+        createPortal: (children: import('react').ReactNode, container: Element) => import('react').ReactNode;
+    };
 }
 declare const TranscriptBox: {
-    ({ allMessages, showTranscript, handleCloseTranscript: _handleCloseTranscript, handleToggleTranscript, showTextInput, textInput, setTextInput, handleTextSubmit, handleTextKeyPress, textPlaceholder, micPosition, transcriptPosition, hasMic, isMuted, handleToggleMute, isConversationActive: _isConversationActive, handleResetChat, showSettings, setShowSettings, isDataChannelOpen, isResponseActive, React, }: TranscriptBoxProps): import("react").JSX.Element | null;
+    (props: TranscriptBoxProps): import("react").JSX.Element | null;
     displayName: string;
 };
 export default TranscriptBox;

package/dist/components/TranscriptMessages.d.ts

@@ -1,8 +1,15 @@
 import { StoredMessage } from '../utils/messageStorage';
+import type { StubWorkspaceOption } from '../stubs/workspaces';
+import type { TranscriptSessionMode } from '../types/GuideAI.types';
 interface TranscriptMessagesProps {
     allMessages: StoredMessage[];
     messagesEndRef: React.RefObject<HTMLDivElement>;
+    docFormProgress?: 'off' | 'extracting' | 'filling';
+    workspaceSelectorPosted?: boolean;
+    workspaceOptions?: StubWorkspaceOption[];
+    selectedWorkspaceId?: TranscriptSessionMode;
+    onSelectWorkspace?: (mode: TranscriptSessionMode) => void;
     React: typeof import('react');
 }
-declare const TranscriptMessages: ({ allMessages, messagesEndRef, React }: TranscriptMessagesProps) => import("react").JSX.Element;
+declare const TranscriptMessages: ({ allMessages, messagesEndRef, docFormProgress, workspaceSelectorPosted, workspaceOptions, selectedWorkspaceId, onSelectWorkspace, React, }: TranscriptMessagesProps) => import("react").JSX.Element;
 export default TranscriptMessages;

package/dist/components/TranscriptTextInput.d.ts

@@ -1,12 +1,51 @@
+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 { MicPresetId } from '../types/audioConfig.types';
 interface TranscriptTextInputProps {
     textInput?: string;
     setTextInput?: (value: string) => void;
     handleTextSubmit?: () => void;
-    handleTextKeyPress?: (event: React.KeyboardEvent) => void;
+    handleTextKeyPress?: (event: import('react').KeyboardEvent<HTMLTextAreaElement>) => void;
     textPlaceholder?: string;
+    /** Connection status message (e.g. "Initializing...", "Retrying...") - shown when channel not open */
+    connectionMessage?: string | null;
     isDataChannelOpen?: boolean;
     isResponseActive?: boolean;
+    sessionMode: TranscriptSessionMode;
+    onSessionModeChange: (mode: TranscriptSessionMode) => void;
+    recordingStatus?: RecordingStatus;
+    isConnecting?: boolean;
+    hasMic?: boolean;
+    isMuted?: boolean;
+    handleToggleMute?: () => void;
+    isAssistantPlaybackMuted?: boolean;
+    onToggleAssistantPlaybackMute?: () => void;
+    handleResetChat?: () => void;
+    onOpenConfig?: () => void;
+    /** GuideAI.debug.showMoreMenu() in console */
+    debugMoreMenuEnabled?: boolean;
+    /** Transcript ⋯ → Debug: playback interrupt lock overlay (top-left panel). */
+    playbackLockDebugOverlayVisible?: boolean;
+    onTogglePlaybackLockDebugOverlay?: () => void;
+    /** User mic preset shown in ⋯ menu. */
+    micPreset?: MicPresetId;
+    /** Apply mic preset (persists + updates session config). */
+    onApplyMicPreset?: (preset: MicPresetId) => void;
+    visualContextFeatureEnabled?: boolean;
+    workspaceOptions: StubWorkspaceOption[];
+    /** Debug ⋯: reflects 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.
+     */
+    transcriptPanelMode?: TranscriptPanelMode;
+    ReactDOM?: {
+        createPortal: (children: import('react').ReactNode, container: Element) => import('react').ReactNode;
+    };
     React: typeof import('react');
 }
-declare const TranscriptTextInput: ({ textInput, setTextInput, handleTextSubmit, handleTextKeyPress, textPlaceholder, isDataChannelOpen, isResponseActive, React, }: TranscriptTextInputProps) => import("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, onOpenConfig, debugMoreMenuEnabled, playbackLockDebugOverlayVisible, onTogglePlaybackLockDebugOverlay, micPreset, onApplyMicPreset, visualContextFeatureEnabled, workspaceOptions, workspaceDataSource, transcriptPanelMode, ReactDOM, React, }: TranscriptTextInputProps) => React.JSX.Element;
 export default TranscriptTextInput;

package/dist/components/TranscriptToolbar.d.ts

@@ -0,0 +1,23 @@
+import type { TranscriptPanelMode } from '../types/GuideAI.types';
+interface TranscriptToolbarProps {
+    /** When true, show n/N progress beside the workflow title (onboarding / checklist workspaces). */
+    workflowChecklistEnabled: boolean;
+    /** Checked workflow steps vs total (e.g. 2 / 16). */
+    workflowCheckedCount: number;
+    workflowTotalCount: number;
+    /** Workflow title (active row, next step, or session label fallback). */
+    displayWorkflowTitle: string;
+    workflowDrawerOpen: boolean;
+    /** Opens the checklist when closed; closes it when open. */
+    onToggleWorkflowDrawer: () => void;
+    /** Ends the voice session and closes the connection (same as status control in the input row). */
+    onEndSession: () => void;
+    transcriptPanelMode: TranscriptPanelMode;
+    onToggleTranscriptPanelMode: () => void;
+    React: typeof import('react');
+}
+declare const TranscriptToolbar: {
+    ({ workflowChecklistEnabled, workflowCheckedCount, workflowTotalCount, displayWorkflowTitle, workflowDrawerOpen, onToggleWorkflowDrawer, onEndSession, transcriptPanelMode, onToggleTranscriptPanelMode, React, }: TranscriptToolbarProps): import("react").JSX.Element;
+    displayName: string;
+};
+export default TranscriptToolbar;

package/dist/components/TranscriptWorkflowDrawer.d.ts

@@ -0,0 +1,39 @@
+import type { TranscriptPanelMode } from '../types/GuideAI.types';
+import type { StubWorkflowItem } from '../stubs/workspaces';
+interface TranscriptWorkflowDrawerProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** `docked` = DockedPanel (full-height side); `float` = FloatPanel (card). */
+    transcriptPanelMode: TranscriptPanelMode;
+    /** Mode + layout controls; in float mode it sits inside the expanding clip under the slim handle. */
+    toolbar: import('react').ReactNode;
+    workflowChecked: Record<string, boolean>;
+    onToggleWorkflowCheck: (id: string) => void;
+    /** When false, steps are navigation-only (no checkboxes); onboarding keeps checklist + toolbar n/N. */
+    workflowChecklistEnabled: boolean;
+    /** When false, checking a step does not play confetti (stub workspace option). */
+    workflowConfettiEnabled?: boolean;
+    /** Choosing a workflow row closes the drawer; parent sets toolbar title. */
+    onWorkflowActivate: (id: string, label: string) => void;
+    /** Selected workflow id, else first unchecked step — row highlight. */
+    highlightedWorkflowId: string | null;
+    workflows: StubWorkflowItem[];
+    /** Current workspace name (replaces static “Workflows” in the drawer header). */
+    workspaceTitle: string;
+    /** Same blurb as under each selector option; shown under the title in the drawer. */
+    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;
+    };
+    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;
+    displayName: string;
+};
+export default TranscriptWorkflowDrawer;

package/dist/components/WelcomeBubble.d.ts

@@ -1,7 +1,12 @@
 import { PopupPosition } from '../types/GuideAI.types';
 interface WelcomeBubbleProps {
     position: PopupPosition;
+    message: string;
+    /** Play hide animation before unmount (position-aware CSS). */
+    exiting?: boolean;
+    /** Apply `guideai-welcome-bubble-enter-mount` (default enter + bubble-pulse). */
+    enterMount?: boolean;
     React: typeof import('react');
 }
-declare const WelcomeBubble: ({ position, React }: WelcomeBubbleProps) => import("react").JSX.Element;
+declare const WelcomeBubble: ({ position, message, exiting, enterMount, React, }: WelcomeBubbleProps) => import("react").JSX.Element;
 export default WelcomeBubble;

package/dist/components/WorkspaceStubIcon.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+/** Renders the workspace pill / drawer icon (ids match admin workspace config). */
+export declare function WorkspaceStubIcon({ icon, className }: {
+    icon: string;
+    className: string;
+}): React.JSX.Element;

package/dist/contexts/AdminToolDiagnosticsContext.d.ts

@@ -0,0 +1,6 @@
+export type AdminToolDiagnosticsContextValue = {
+    open: boolean;
+    toggle: () => void;
+};
+/** `null` when the debug "more" menu is off. Used by the transcript ⋯ → Tool diagnostics row. */
+export declare const AdminToolDiagnosticsContext: import("react").Context<AdminToolDiagnosticsContextValue | null>;

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

@@ -0,0 +1,16 @@
+/**
+ * Admin Tool Diagnostics — transcript ⋯ → Debug.
+ * Self-contained under `src/devtools/adminToolDiagnostics/`.
+ */
+import React from 'react';
+export interface AdminToolDiagnosticsPanelProps {
+    React: typeof import('react');
+    ReactDOM?: {
+        createPortal?: (children: import('react').ReactNode, c: Element) => import('react').ReactNode;
+    };
+    runTool: (name: string, argsJson: string) => Promise<unknown>;
+    getToolNames: () => string[];
+    getSampleArgsJsonForToolName: (name: string) => string;
+    onClose: () => void;
+}
+export declare const AdminToolDiagnosticsPanel: ({ React: R, ReactDOM, runTool, getToolNames, getSampleArgsJsonForToolName, onClose, }: AdminToolDiagnosticsPanelProps) => React.JSX.Element;

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

@@ -0,0 +1,8 @@
+export declare const REFRESH_MIN_MS = 200;
+export declare const COPY_FLASH_MS = 1200;
+export declare function getInitialATDPosition(): {
+    left: number;
+    top: number;
+};
+export declare function formatToolResult(r: unknown): string;
+export declare function copyTextToClipboard(text: string): Promise<boolean>;

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

@@ -0,0 +1,5 @@
+/**
+ * Admin Tool Diagnostics — self-contained dev-tool styles (`guideai-atd-*`).
+ * Remove: this file + `adminToolDiagnosticsStyles()` in `GuideAI.styles.ts` + `DeveloperTools` in `GuideAI.tsx`.
+ */
+export declare const adminToolDiagnosticsStyles: () => string;

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

@@ -0,0 +1,6 @@
+import type { ToolWithConfig } from '../../utils/tools/toolRegistry';
+/**
+ * Merged list of tool names for the admin diagnostics panel when no live session
+ * is available, or to supplement session state.
+ */
+export declare function buildDiagnosticsToolNameList(toolsConfig: ToolWithConfig[], propToolNames: string[] | undefined): string[];

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

@@ -0,0 +1,5 @@
+/**
+ * Prefer `#id` when present; otherwise `data-testid` / `name` on controls, or structural path.
+ * Used only by the admin tool diagnostics devtool.
+ */
+export declare function getIdOrFallbackSelectorForDiagnostics(element: Element | null | undefined): string;

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

@@ -0,0 +1,2 @@
+export { AdminToolDiagnosticsPanel, type AdminToolDiagnosticsPanelProps, } from './AdminToolDiagnosticsPanel';
+export { adminToolDiagnosticsStyles } from './adminToolDiagnosticsStyles';

package/dist/devtools/useDraggableDialog.d.ts

@@ -0,0 +1,23 @@
+import type { PointerEvent as ReactPointerEvent } from 'react';
+export interface DraggableDialogPosition {
+    left: number;
+    top: number;
+}
+interface UseDraggableDialogParams {
+    initialPosition: () => DraggableDialogPosition;
+    minVisibleWidth: number;
+    minVisibleHeight: number;
+    ignoreSelector?: string;
+}
+export declare function useDraggableDialog(React: typeof import('react'), { initialPosition, minVisibleWidth, minVisibleHeight, ignoreSelector, }: UseDraggableDialogParams): {
+    position: DraggableDialogPosition;
+    setPosition: import("react").Dispatch<import("react").SetStateAction<DraggableDialogPosition>>;
+    dialogRef: import("react").MutableRefObject<HTMLDivElement | null>;
+    dragHandlers: {
+        onPointerDown: (e: ReactPointerEvent<HTMLDivElement>) => void;
+        onPointerMove: (e: ReactPointerEvent<HTMLDivElement>) => void;
+        onPointerUp: (e: ReactPointerEvent<HTMLDivElement>) => void;
+        onPointerCancel: (e: ReactPointerEvent<HTMLDivElement>) => void;
+    };
+};
+export {};

package/dist/devtools/visualContextInspector/BufferIndicator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Visual buffer-full indicator. Polls the host's `getBufferedAmount` callback ~5×/s
+ * and draws a horizontal bar: green → yellow → red as fill approaches the threshold.
+ * Ships as a fully-contained component so the Inspector folder stays self-sufficient.
+ */
+import React from 'react';
+export interface BufferIndicatorProps {
+    React: typeof import('react');
+    getBufferedAmount: () => number;
+    /** WebRTC bufferedAmount threshold at which `isBufferFull()` returns true. */
+    threshold: number;
+    /** How often to sample the buffered amount (ms). Defaults to 200. */
+    pollMs?: number;
+}
+export declare const BufferIndicator: React.FC<BufferIndicatorProps>;

package/dist/devtools/visualContextInspector/ConfigSection.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Config editor section inside the Visual Context Inspector.
+ *
+ * Uses only `guideai-vci-*` classes. Each label carries an info icon that reveals a
+ * short description (from `VC_FIELD_INFO`) on hover.
+ */
+import React from 'react';
+import type { VisualContextLiveHandle } from '../../visualContext/useVisualContext';
+export interface ConfigSectionProps {
+    React: typeof import('react');
+    open: boolean;
+    onToggle: () => void;
+    handle: VisualContextLiveHandle;
+    /** Called when the user hovers an info icon. Inspector owns the tooltip placement. */
+    onShowTooltip: (field: string, rect: DOMRect) => void;
+    onHideTooltip: () => void;
+}
+export declare const ConfigSection: React.FC<ConfigSectionProps>;

package/dist/devtools/visualContextInspector/ScreenshotList.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Reverse-chronological list of capture events, each annotated with its trigger reason
+ * and send outcome. Items show a thumbnail + timestamps + (if skipped) the skip gate
+ * so the whole capture → decision → send loop is diagnosable at a glance.
+ */
+import React from 'react';
+import type { CaptureLogEntry } from './types';
+export interface ScreenshotListProps {
+    React: typeof import('react');
+    entries: CaptureLogEntry[];
+    onThumbClick?: (entry: CaptureLogEntry) => void;
+}
+export declare const ScreenshotList: React.FC<ScreenshotListProps>;

package/dist/devtools/visualContextInspector/VisualContextInspector.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Visual Context Inspector — dev-tool dialog that ties together the buffer indicator,
+ * runtime config editor, and capture/send log.
+ *
+ * All classes are `guideai-vci-*` so this panel has its own dedicated stylesheet
+ * namespace and doesn't share rules with any other dialog in the package. Visuals
+ * resemble the Audio Configuration dialog but the two are independent.
+ *
+ * Mount is gated by `visualContext.inspectorOpen` from `useVisualContext`, passed through
+ * `GuideAI.tsx` into `DeveloperTools` as `visualContext.show`. Toggled from the transcript
+ * ⋯ → Debug → "Show/Hide Inspector" menu (or `GuideAI.visualContext.toggleInspector()`).
+ *
+ * Deleting this folder + removing the import + conditional render in `DeveloperTools.tsx` +
+ * the `visualContext` prop from `GuideAI.tsx` + `visualContextInspectorStyles` in
+ * `GuideAI.styles.ts` removes the dev-tool.
+ */
+import React from 'react';
+import type { VisualContextLiveHandle } from '../../visualContext/useVisualContext';
+export interface VisualContextInspectorProps {
+    React: typeof import('react');
+    /** Optional ReactDOM with `createPortal` — enables portaled hover tooltips for info icons. */
+    ReactDOM?: {
+        createPortal?: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
+    handle: VisualContextLiveHandle;
+    /** WebRTC buffered byte count getter. */
+    getBufferedAmount: () => number;
+    /** WebRTC bufferedAmount threshold at which sends are gated. */
+    bufferThresholdBytes: number;
+    /** Close the panel. */
+    onClose: () => void;
+    onTestScreenshot: () => void;
+    /** Clears the in-memory frame store (`VisualContextStore`). */
+    onClearBuffer: () => void;
+}
+export declare const VisualContextInspector: React.FC<VisualContextInspectorProps>;

package/dist/devtools/visualContextInspector/fieldInfo.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Hover-help descriptions for every Visual Context config field shown in the Inspector.
+ *
+ * Keep concise (~2–3 lines each) so the tooltip fits its 240px max-width without scroll.
+ * These map 1:1 to the fields in `ConfigSection.tsx`.
+ */
+export declare const VC_FIELD_INFO: Record<string, string>;

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

@@ -0,0 +1,13 @@
+/**
+ * Public barrel for the Visual Context Inspector dev-tool.
+ *
+ * The entire dev-tool lives under this folder. To remove it in a production-only build,
+ * delete this folder, remove the `VisualContextInspector` import + conditional render from
+ * `src/components/DeveloperTools.tsx`, drop the `visualContext` prop passed from `GuideAI.tsx`,
+ * and remove `visualContextInspectorStyles` from `GuideAI.styles.ts`. Visibility is driven by
+ * `useVisualContext`'s `inspectorOpen` state / `GuideAI.visualContext.toggleInspector()`.
+ */
+export { VisualContextInspector } from './VisualContextInspector';
+export type { VisualContextInspectorProps } from './VisualContextInspector';
+export { inspectorStore } from './inspectorStore';
+export type { CaptureLogEntry, InspectorSnapshot } from './types';