guideai-app 0.5.4-2 → 0.5.4-3

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

@@ -0,0 +1,6 @@
+/** One `data:` JSON payload from the companion SSE stream. */
+export type ExcavatorSseEvent = Record<string, unknown>;
+/**
+ * Consume crawler companion `text/event-stream` chat responses (same wire format as `crawler/public/app.js`).
+ */
+export declare function consumeExcavatorSseChat(response: Response, onEvent: (ev: ExcavatorSseEvent) => void): Promise<ExcavatorSseEvent | null>;

package/dist/devtools/learn/LearnCaptureChrome.stub.d.ts

@@ -0,0 +1,3 @@
+import type { LearnCaptureChromeProps } from './learnCaptureChrome';
+/** No-op when GUIDEAI_STRIP_DEVTOOLS=1 */
+export default function LearnCaptureChromeStub(_props: LearnCaptureChromeProps): null;

package/dist/devtools/learn/LearnModePanel.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { LearnPhase } from './learnModeTypes';
+export interface LearnModePanelProps {
+    embedded?: boolean;
+    phase: LearnPhase;
+    workspaceLabel: string;
+    proposedTitle: string;
+    onProposedTitleChange: (t: string) => void;
+    clarifyDone: boolean;
+    onClarifyDone: () => void;
+    onStartCapture: () => void | Promise<void>;
+    onGenerate: () => void | Promise<void>;
+    onCancel: () => void;
+    generatedWorkflowId: string | null;
+    adminWorkflowUrl: string | null;
+}
+declare const LearnModePanel: ({ embedded, phase, workspaceLabel, proposedTitle, onProposedTitleChange, clarifyDone, onClarifyDone, onStartCapture, onGenerate, onCancel, generatedWorkflowId, adminWorkflowUrl, }: LearnModePanelProps) => React.JSX.Element;
+export default LearnModePanel;

package/dist/devtools/learn/LearnModePanel.stub.d.ts

@@ -0,0 +1,3 @@
+import type { LearnModePanelProps } from './LearnModePanel';
+/** No-op when GUIDEAI_STRIP_DEVTOOLS=1 */
+export default function LearnModePanelStub(_props: LearnModePanelProps): null;

package/dist/devtools/learn/LearnOrchestrationHost.d.ts

@@ -0,0 +1,52 @@
+import React from 'react';
+import type { MutableRefObject } from 'react';
+import type { ReactHooks } from '../../utils/reactHooks';
+import type { GuideAIEnvironment } from '../../types/GuideAI.types';
+import type { RecordingStatus } from '../../types/GuideAI.types';
+import type { StoredMessage } from '../../utils/messageStorage';
+import type { ConversationManager } from '../../utils/conversationManager';
+import type { DataChannelManager } from '../../utils/dataChannel';
+import type { LearnModePanelProps } from './LearnModePanel';
+import { type UseLearnModeResult } from './useLearnMode';
+import type { LearnRealtimeSessionDeps } from './learnRealtimeSession';
+export type LearnOrchestrationHostProps = {
+    hooks: ReactHooks;
+    React: typeof import('react');
+    ReactDOM?: {
+        createPortal: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
+    adminAvailable: boolean;
+    environment?: GuideAIEnvironment;
+    portalToken: string | null;
+    workspaceSlug: string;
+    workspaceName: string;
+    zIndexDevTools: number;
+    recordingStatus: RecordingStatus;
+    isConnecting: boolean;
+    connectionMessage?: string | null;
+    hasMic: boolean;
+    conversationIdRef: MutableRefObject<string | null>;
+    getConversationManager: () => ConversationManager | null;
+    getDataChannelManager: () => DataChannelManager | null;
+    cleanupWebRTC: () => void;
+    realtimeSessionDeps: LearnRealtimeSessionDeps;
+    performResetChat: () => void | Promise<void>;
+    handleToggleMute: () => void;
+    applyMicMuted: (muted: boolean) => void;
+    isMuted: boolean;
+    isAssistantPlaybackMuted: boolean;
+    handleToggleAssistantPlaybackMute: () => void;
+    syncTranscriptFromStorage: () => void;
+    allMessages: StoredMessage[];
+    onLearnFocusEnter?: () => void;
+    onLearnFocusExit?: () => void;
+    onLearnPanelChange: (learn: LearnModePanelProps) => void;
+    onLearnRuntimeChange: (runtime: {
+        learnFocusMode: boolean;
+        finishClarifying: UseLearnModeResult['finishClarifying'];
+    }) => void;
+    onDoneClarifyingRef: MutableRefObject<(() => void) | null>;
+    openShellOnTabRef: MutableRefObject<((tab: 'learn') => void) | null>;
+    closeShell: () => void;
+};
+export declare function LearnOrchestrationHost({ hooks, React, ReactDOM, adminAvailable, environment, portalToken, workspaceSlug, workspaceName, zIndexDevTools, recordingStatus, isConnecting, connectionMessage, hasMic, conversationIdRef, getConversationManager, getDataChannelManager, cleanupWebRTC, realtimeSessionDeps, performResetChat, handleToggleMute, applyMicMuted, isMuted, isAssistantPlaybackMuted, handleToggleAssistantPlaybackMute, syncTranscriptFromStorage, allMessages, onLearnFocusEnter, onLearnFocusExit, onLearnPanelChange, onLearnRuntimeChange, onDoneClarifyingRef, openShellOnTabRef, closeShell, }: LearnOrchestrationHostProps): React.JSX.Element | null;

package/dist/devtools/learn/injectLearnModeStyles.d.ts

@@ -0,0 +1,2 @@
+/** Inject learn capture + devtools panel CSS once (first Learn activation). */
+export declare function injectLearnModeStyles(): void;

package/dist/devtools/learn/learnCaptureChrome.d.ts

@@ -0,0 +1,33 @@
+import React from 'react';
+import type { StoredMessage } from '../../utils/messageStorage';
+import type { LearnPhase } from './learnModeTypes';
+import type { RecordingStatus } from '../../types/GuideAI.types';
+import type { ConversationManager } from '../../utils/conversationManager';
+import type { DataChannelManager } from '../../utils/dataChannel';
+import type { ReactHooks } from '../../utils/reactHooks';
+export type LearnCaptureChromeProps = {
+    React: typeof import('react');
+    ReactDOM?: {
+        createPortal: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
+    hooks: ReactHooks;
+    phase: LearnPhase;
+    capturePausedAt: number | null;
+    workspaceLabel: string;
+    allMessages: StoredMessage[];
+    syncTranscriptFromStorage: () => void;
+    onPause: () => void;
+    onResume: () => void;
+    onStop: () => void | Promise<void>;
+    onDoneClarifying: () => void;
+    clarifyDone: boolean;
+    getConversationManager: () => ConversationManager | null;
+    getDataChannelManager: () => DataChannelManager | null;
+    recordingStatus: RecordingStatus;
+    isConnecting: boolean;
+    connectionMessage?: string | null;
+    hasMic: boolean;
+    zIndex: number;
+};
+declare function LearnCaptureChrome({ React: R, ReactDOM, hooks, phase, capturePausedAt, workspaceLabel, allMessages, syncTranscriptFromStorage, onPause, onResume, onStop, onDoneClarifying, clarifyDone, getConversationManager, getDataChannelManager, recordingStatus, isConnecting, connectionMessage, hasMic, zIndex, }: LearnCaptureChromeProps): string | number | boolean | Iterable<React.ReactNode> | React.JSX.Element | null | undefined;
+export default LearnCaptureChrome;

package/dist/devtools/learn/learnCaptureLayout.d.ts

@@ -0,0 +1,26 @@
+import type { DraggableDialogPosition } from '../useDraggableDialog';
+/** Default width for learn capture chrome; keep in sync with `.guideai-learn-capture-root` in `learnModeStyles.ts`. */
+export declare const LEARN_CAPTURE_PANEL_WIDTH_PX = 420;
+/** Default max height for learn capture chrome; keep in sync with `.guideai-learn-capture-root`. */
+export declare const LEARN_CAPTURE_PANEL_MAX_HEIGHT_PX = 360;
+export declare const LEARN_CAPTURE_MARGIN_PX = 16;
+/** Panel size used for drag clamp (measured when possible). */
+export declare function getLearnCaptureClampExtents(element?: HTMLElement | null): {
+    width: number;
+    height: number;
+};
+/** Bottom-right default (matches pre-drag fixed placement). */
+export declare function getDefaultLearnCapturePosition(): DraggableDialogPosition;
+/** Clamp a stored / dragged position so the full panel (incl. toolbar) stays on-screen. */
+export declare function clampLearnCapturePosition(position: DraggableDialogPosition, element?: HTMLElement | null): DraggableDialogPosition;
+/** Bottom offset from viewport bottom for a top-anchored panel box. */
+export declare function learnCaptureBottomFromTop(top: number, panelHeight: number): number;
+/**
+ * Clamp while preserving the panel bottom edge (transcript growth expands upward).
+ * Returns settled `top` for drag state/localStorage and `bottom` for fixed positioning.
+ */
+export declare function clampLearnCapturePositionWithBottomAnchor(position: DraggableDialogPosition, bottomAnchor: number, element?: HTMLElement | null): DraggableDialogPosition & {
+    bottom: number;
+};
+/** Restored position from localStorage, or the default bottom-right placement. */
+export declare function getLearnCaptureInitialPosition(): DraggableDialogPosition;

package/dist/devtools/learn/learnCaptureToolbar.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+import type { PointerEvent as ReactPointerEvent } from 'react';
+import type { RecordingStatus } from '../../types/GuideAI.types';
+export type LearnCaptureToolbarDragHandlers = {
+    onPointerDown: (e: ReactPointerEvent<HTMLDivElement>) => void;
+    onPointerMove: (e: ReactPointerEvent<HTMLDivElement>) => void;
+    onPointerUp: (e: ReactPointerEvent<HTMLDivElement>) => void;
+    onPointerCancel: (e: ReactPointerEvent<HTMLDivElement>) => void;
+};
+export type LearnCaptureToolbarProps = {
+    dragHandlers?: LearnCaptureToolbarDragHandlers;
+    recordingStatus: RecordingStatus;
+    isConnecting: boolean;
+    connectionMessage?: string | null;
+    hasMic: boolean;
+    /** When true (capture pause), VAD is greyed out; mic/playback are muted elsewhere. */
+    vadPaused: boolean;
+    capturing: boolean;
+    clarifying?: boolean;
+    clarifyDone?: boolean;
+    paused: boolean;
+    onPause: () => void;
+    onResume: () => void;
+    onStop: () => void | Promise<void>;
+    onDoneClarifying?: () => void;
+};
+export declare function LearnCaptureToolbar({ dragHandlers, recordingStatus, isConnecting, connectionMessage, hasMic, vadPaused, capturing, clarifying, clarifyDone, paused, onPause, onResume, onStop, onDoneClarifying, }: LearnCaptureToolbarProps): React.JSX.Element;

package/dist/devtools/learn/learnClarifyKickoff.d.ts

@@ -0,0 +1,6 @@
+import type { ConversationManager } from '../../utils/conversationManager';
+import type { DataChannelManager } from '../../utils/dataChannel';
+/**
+ * After clarify re-init, wait for the data channel then request the first assistant turn.
+ */
+export declare function triggerLearnClarifyKickoff(getDataChannelManager: () => DataChannelManager | null, getConversationManager: () => ConversationManager | null): Promise<void>;

package/dist/devtools/learn/learnLiteTranscript.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { StoredMessage } from '../../utils/messageStorage';
+export type LearnLiteLine = {
+    kind: 'narration';
+    text: string;
+    key: string;
+} | {
+    kind: 'assistant';
+    text: string;
+    key: string;
+} | {
+    kind: 'click';
+    selector: string;
+    key: string;
+};
+export declare function buildLearnLiteLines(messages: StoredMessage[]): LearnLiteLine[];
+export type LearnLiteTranscriptProps = {
+    lines: LearnLiteLine[];
+    /** Clarifying phase — Q&A copy instead of capture listening hint. */
+    clarifying?: boolean;
+};
+export declare function LearnLiteTranscript({ lines, clarifying }: LearnLiteTranscriptProps): React.JSX.Element;

package/dist/devtools/learn/learnModeStyles.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Learn mode — capture chrome (`guideai-learn-*`) + devtools panel scoped under
+ * `[data-guideai-devtool="learn-panel"]` (uses shared `guideai-atd-*` chrome).
+ */
+export declare const learnModeStyles: () => string;

package/dist/devtools/learn/learnModeTypes.d.ts

@@ -0,0 +1,5 @@
+export type LearnPhase = 'off' | 'capturing' | 'capturing_paused' | 'clarifying' | 'generating';
+export declare function learnModeActiveForInit(phase: LearnPhase): boolean;
+export declare function learnCaptureOkClampPhase(phase: LearnPhase): string | null;
+/** Lite capture chrome (banner + lite transcript + toolbar); hides full transcript shell. */
+export declare function learnFocusModeActive(phase: LearnPhase, clarifyDone: boolean): boolean;

package/dist/devtools/learn/learnOrchestrationStub.d.ts

@@ -0,0 +1,5 @@
+import type { LearnModePanelProps } from './LearnModePanel';
+import type { LearnPhase } from './learnModeTypes';
+export declare const LEARN_PHASE_OFF: LearnPhase;
+/** Learn panel props before lazy orchestration loads (phase stays off). */
+export declare function createLearnOrchestrationStub(onRequestOrchestration: () => void): LearnModePanelProps;

package/dist/devtools/learn/learnPanelSyncFieldsEqual.d.ts

@@ -0,0 +1,3 @@
+import type { LearnModePanelProps } from './LearnModePanel';
+/** Serializable Learn panel fields — ignore callback identity when syncing shell state. */
+export declare function areLearnPanelSyncFieldsEqual(prev: LearnModePanelProps, next: LearnModePanelProps): boolean;

package/dist/devtools/learn/learnRealtimeSession.d.ts

@@ -0,0 +1,10 @@
+import type { MutableRefObject } from 'react';
+import type { RecordingStatus } from '../../types/GuideAI.types';
+export type LearnRealtimeSessionDeps = {
+    hasInitializedRef: MutableRefObject<boolean>;
+    startConversationSession: () => Promise<boolean>;
+    setStatus: (status: RecordingStatus) => void;
+    setIsConversationActive: (active: boolean) => void;
+};
+/** Ensure a realtime voice session for Learn capture / clarify (moved out of GuideAI). */
+export declare function createEnsureLearnRealtimeSession(deps: LearnRealtimeSessionDeps): () => Promise<boolean>;

package/dist/devtools/learn/learnRefBag.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Module-level learn refs for WebRTC / data-channel hot paths (no GuideAI re-renders).
+ * `useLearnMode` syncs these when phase changes.
+ */
+export declare const learnModeRef: {
+    current: boolean;
+};
+export declare const learnInitPhaseRef: {
+    current: "capture" | "clarify";
+};
+export declare const learnClarifyConversationIdRef: {
+    current: string | null;
+};
+export declare const learnCapturePhaseRef: {
+    current: string | null;
+};
+/**
+ * Capture-phase conversation id to reuse on connect. Normally `null` (each Start capture creates a
+ * fresh learn conversation); set only when restoring a capture session after a page reload so the
+ * reconnect re-attaches to the original conversation instead of forking a new one.
+ */
+export declare const learnCaptureConversationIdRef: {
+    current: string | null;
+};
+export declare const learnRefBag: {
+    learnModeRef: {
+        current: boolean;
+    };
+    learnInitPhaseRef: {
+        current: "capture" | "clarify";
+    };
+    learnClarifyConversationIdRef: {
+        current: string | null;
+    };
+    learnCapturePhaseRef: {
+        current: string | null;
+    };
+    learnCaptureConversationIdRef: {
+        current: string | null;
+    };
+};

package/dist/devtools/learn/learnSessionStorage.d.ts

@@ -0,0 +1,23 @@
+import type { LearnPhase } from './learnModeTypes';
+/** Phases worth restoring after a reload — `off` / `generating` are never persisted directly. */
+export type RestorableLearnPhase = Extract<LearnPhase, 'capturing' | 'capturing_paused' | 'clarifying'>;
+export type PendingLearnSession = {
+    phase: RestorableLearnPhase;
+    /** Server learn conversation id (capture conversation; reused for clarify re-init + generate). */
+    conversationId: string;
+    /** Locked workspace slug for generate. */
+    workspaceSlug: string;
+    proposedTitle: string;
+    /** True once the admin clicked "Done clarifying" (focus exited; Generate available). */
+    clarifyDone: boolean;
+    /** Ms since epoch — when the session was last persisted. */
+    startedAt: number;
+};
+export declare function getPendingLearnSession(): PendingLearnSession | null;
+export declare function refreshLearnSessionActiveFlag(): void;
+/** Cheap, allocation-free check for hot paths (e.g. GuideAI auto-restore gate). */
+export declare function isLearnSessionActive(): boolean;
+/** True when sessionStorage holds a resumable learn session (no side effects). */
+export declare function hasPendingLearnSession(): boolean;
+export declare function setPendingLearnSession(session: PendingLearnSession): void;
+export declare function clearPendingLearnSession(): void;

package/dist/devtools/learn/learnWorkspaceContext.d.ts

@@ -0,0 +1,5 @@
+import type { StubWorkspaceOption } from '../../stubs/workspaces';
+export declare function resolveLearnWorkspaceContext(transcriptSessionMode: string, workspaceOptions: StubWorkspaceOption[], widgetAuthWorkspace?: string): {
+    workspaceSlug: string;
+    workspaceName: string;
+};

package/dist/devtools/learn/loadLearnOrchestration.d.ts

@@ -0,0 +1,10 @@
+import type { ComponentType } from 'react';
+import type { LearnOrchestrationHostProps } from './LearnOrchestrationHost';
+export type LearnOrchestrationLoadResult = {
+    LearnOrchestrationHost: ComponentType<LearnOrchestrationHostProps>;
+};
+/**
+ * Dynamic entry for Learn orchestration (`useLearnMode`, capture chrome, focus callbacks).
+ * Loaded on first Learn tab open or Start capture — not on widget mount.
+ */
+export declare function loadLearnOrchestration(): Promise<LearnOrchestrationLoadResult>;

package/dist/devtools/learn/useLearnCaptureDuration.d.ts

@@ -0,0 +1,4 @@
+import type { ReactHooks } from '../../utils/reactHooks';
+import type { LearnPhase } from './learnModeTypes';
+/** Elapsed capture time in MM:SS, excluding paused intervals. */
+export declare function useLearnCaptureDuration(hooks: ReactHooks, phase: LearnPhase, capturePausedAt: number | null): string;

package/dist/devtools/learn/useLearnClickCapture.d.ts

@@ -0,0 +1,9 @@
+import type { ReactHooks } from '../../utils/reactHooks';
+import type { ConversationManager } from '../../utils/conversationManager';
+import type { DataChannelManager } from '../../utils/dataChannel';
+import type { LearnPhase } from './learnModeTypes';
+export declare function useLearnClickCapture(hooks: ReactHooks, params: {
+    phase: LearnPhase;
+    getConversationManager: () => ConversationManager | null;
+    getDataChannelManager: () => DataChannelManager | null;
+}): void;

package/dist/devtools/learn/useLearnMode.d.ts

@@ -0,0 +1,47 @@
+import type { ReactHooks } from '../../utils/reactHooks';
+import type { GuideAIEnvironment } from '../../types/GuideAI.types';
+import type { ConversationManager } from '../../utils/conversationManager';
+import type { DataChannelManager } from '../../utils/dataChannel';
+import { type LearnPhase } from './learnModeTypes';
+export type UseLearnModeParams = {
+    hooks: ReactHooks;
+    adminAvailable: boolean;
+    conversationIdRef: {
+        current: string | null;
+    };
+    getConversationManager: () => ConversationManager | null;
+    getDataChannelManager: () => DataChannelManager | null;
+    cleanupWebRTC: () => void;
+    ensureRealtimeSession: () => Promise<boolean>;
+    /** Whether the host widget has finished its initial setup (gates reload-restore reconnect). */
+    isWidgetInitialized: () => boolean;
+    /** Same as transcript Reset chat (`handleResetChat`), without confirm. */
+    performResetChat: () => void | Promise<void>;
+    handleToggleMute: () => void;
+    applyMicMuted: (muted: boolean) => void;
+    isMuted: boolean;
+    isAssistantPlaybackMuted: boolean;
+    handleToggleAssistantPlaybackMute: () => void;
+    workspaceSlug: string;
+    environment?: GuideAIEnvironment;
+    portalToken: string | null;
+    syncTranscriptFromStorage: () => void;
+};
+export type UseLearnModeResult = {
+    phase: LearnPhase;
+    learnFocusMode: boolean;
+    capturePausedAt: number | null;
+    proposedTitle: string;
+    setProposedTitle: (t: string) => void;
+    generatedWorkflowId: string | null;
+    adminWorkflowUrl: string | null;
+    clarifyDone: boolean;
+    startCapture: () => Promise<void>;
+    pauseCapture: () => void;
+    resumeCapture: () => void;
+    stopCapture: () => Promise<void>;
+    finishClarifying: () => Promise<void>;
+    generateWorkflow: () => Promise<void>;
+    cancelLearn: () => void;
+};
+export declare function useLearnMode(params: UseLearnModeParams): UseLearnModeResult;

package/dist/devtools/learn/useLearnMode.stub.d.ts

@@ -0,0 +1,3 @@
+import type { UseLearnModeParams, UseLearnModeResult } from './useLearnMode';
+/** No-op Learn hook when GUIDEAI_STRIP_DEVTOOLS=1 */
+export declare function useLearnMode(_params: UseLearnModeParams): UseLearnModeResult;

package/dist/devtools/panelLayout.d.ts

@@ -5,3 +5,9 @@ export declare const DEVTOOLS_PANEL_WIDTH_PX = 520;
  * Initial top-left for a right-aligned devtools dialog (avoids overlapping the widget).
  */
 export declare function getInitialRightAlignedPanelPosition(panelWidth: number, top?: number, margin?: number): DraggableDialogPosition;
+/** Clamp a stored / dragged position so the shell stays on-screen. */
+export declare function clampDevtoolsShellPosition(position: DraggableDialogPosition): DraggableDialogPosition;
+/**
+ * Restored shell position from localStorage, or the default right-aligned placement.
+ */
+export declare function getDevtoolsShellInitialPosition(): DraggableDialogPosition;

package/dist/devtools/transcriptDevtoolsMenuProps.d.ts

@@ -0,0 +1,28 @@
+/** Shell toggle control inside transcript ⋯ → Developer tools. */
+export type DeveloperToolsShellControl = {
+    shellOpen: boolean;
+    onToggleShell: () => void;
+} | null;
+import type { GuideAIEnvironment } from '../types/GuideAI.types';
+/** Grouped devtools props for TranscriptBox / TranscriptTextInput / TranscriptToolbar. */
+export type TranscriptDevtoolsMenuProps = {
+    /** Full Developer tools section in ⋯ (extension admin or embed after admin login). */
+    sectionVisible: boolean;
+    shellControl: DeveloperToolsShellControl;
+    /** Open in admin flyout (conversation / workflow). */
+    adminPortal?: {
+        getServerConversationId: () => string | null;
+        environment?: GuideAIEnvironment;
+    };
+    login: {
+        /** Embed: Developer login row after hidden unlock, before admin sign-in. */
+        visible: boolean;
+        onOpen: () => void;
+        showLogout: boolean;
+        onLogout: () => void;
+    };
+    unlock: {
+        /** Embed: triple-click transcript workflow title. No-op in extension. */
+        onToolbarTitleClick: () => void;
+    };
+};

package/dist/devtools/transcriptMoreMenu/DeveloperToolsAdminPortalFlyout.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { GuideAIEnvironment } from '../../types/GuideAI.types';
+type DeveloperToolsAdminPortalFlyoutProps = {
+    open: boolean;
+    flyoutStyle: React.CSSProperties | null;
+    usePortal: boolean;
+    ReactDOM?: {
+        createPortal: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
+    listRef: React.RefObject<HTMLUListElement>;
+    themePortalProps: {
+        'data-guideai-theme'?: string;
+    };
+    getServerConversationId: () => string | null;
+    widgetEnvironment?: GuideAIEnvironment;
+    onCloseMenu: () => void;
+};
+/** Portaled Open in admin submenu (⋯ → Developer tools). */
+export declare function DeveloperToolsAdminPortalFlyout({ open, flyoutStyle, usePortal, ReactDOM, listRef, themePortalProps, getServerConversationId, widgetEnvironment, onCloseMenu, }: DeveloperToolsAdminPortalFlyoutProps): React.ReactNode;
+export {};

package/dist/devtools/transcriptMoreMenu/DeveloperToolsLoggerFlyout.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+type DeveloperToolsLoggerFlyoutProps = {
+    open: boolean;
+    flyoutStyle: React.CSSProperties | null;
+    usePortal: boolean;
+    ReactDOM?: {
+        createPortal: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
+    listRef: React.RefObject<HTMLUListElement>;
+    themePortalProps: {
+        'data-guideai-theme'?: string;
+    };
+};
+/** Portaled Console debugger submenu (⋯ → Developer tools). */
+export declare function DeveloperToolsLoggerFlyout({ open, flyoutStyle, usePortal, ReactDOM, listRef, themePortalProps, }: DeveloperToolsLoggerFlyoutProps): React.ReactNode;
+export {};

package/dist/devtools/transcriptMoreMenu/DeveloperToolsMicPresetFlyout.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { MicPresetId } from '../../types/audioConfig.types';
+import type { DevtoolsDebugFlyoutId } from './devtoolsFlyoutTypes';
+type DeveloperToolsMicPresetFlyoutProps = {
+    moreMenuOpen: boolean;
+    debugFlyout: null | DevtoolsDebugFlyoutId;
+    flyoutStyle: React.CSSProperties | null;
+    usePortal: boolean;
+    ReactDOM?: {
+        createPortal: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
+    listRef: React.RefObject<HTMLUListElement>;
+    themePortalProps: {
+        'data-guideai-theme'?: string;
+    };
+    micPreset: MicPresetId;
+    onApplyMicPreset?: (preset: MicPresetId) => void;
+    onCloseFlyout: () => void;
+    onCloseMenu: () => void;
+};
+export declare function DeveloperToolsMicPresetFlyout({ moreMenuOpen, debugFlyout, flyoutStyle, usePortal, ReactDOM, listRef, themePortalProps, micPreset, onApplyMicPreset, onCloseFlyout, onCloseMenu, }: DeveloperToolsMicPresetFlyoutProps): React.ReactNode;
+export {};

package/dist/devtools/transcriptMoreMenu/TranscriptDeveloperToolsMenuItems.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import type { DeveloperToolsShellControl } from '../transcriptDevtoolsMenuProps';
+import type { DevtoolsDebugFlyoutId } from './devtoolsFlyoutTypes';
+type TranscriptDeveloperToolsMoreMenuItemsProps = {
+    sectionVisible: boolean;
+    shellControl: DeveloperToolsShellControl;
+    loginVisible: boolean;
+    onOpenLogin: () => void;
+    showLogout: boolean;
+    onLogout: () => void;
+    onCloseMenu: () => void;
+    debugFlyout: null | DevtoolsDebugFlyoutId;
+    setDebugFlyout: React.Dispatch<React.SetStateAction<null | DevtoolsDebugFlyoutId>>;
+    loggerFlyoutTriggerRef: React.RefObject<HTMLButtonElement>;
+    adminPortalFlyoutTriggerRef: React.RefObject<HTMLButtonElement>;
+    themeFlyoutTriggerRef: React.RefObject<HTMLButtonElement>;
+    getServerConversationId?: () => string | null;
+};
+/** Developer login + Developer tools rows in transcript ⋯. */
+export declare function TranscriptDeveloperToolsMoreMenuItems({ sectionVisible, shellControl, loginVisible, onOpenLogin, showLogout, onLogout, onCloseMenu, debugFlyout, setDebugFlyout, loggerFlyoutTriggerRef, adminPortalFlyoutTriggerRef, themeFlyoutTriggerRef, getServerConversationId, }: TranscriptDeveloperToolsMoreMenuItemsProps): React.JSX.Element;
+export {};

package/dist/devtools/transcriptMoreMenu/TranscriptDeveloperToolsThemeFlyout.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+type DeveloperToolsThemeFlyoutProps = {
+    open: boolean;
+    flyoutStyle: React.CSSProperties | null;
+    usePortal: boolean;
+    ReactDOM?: {
+        createPortal: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
+    listRef: React.RefObject<HTMLUListElement>;
+    onCloseMenu: () => void;
+};
+export declare function DeveloperToolsThemeFlyout({ open, flyoutStyle, usePortal, ReactDOM, listRef, onCloseMenu, }: DeveloperToolsThemeFlyoutProps): React.ReactNode;
+export {};

package/dist/devtools/transcriptMoreMenu/TranscriptMoreMenuDevtools.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+import type { MicPresetId } from '../../types/audioConfig.types';
+import type { TranscriptDevtoolsMenuProps } from '../transcriptDevtoolsMenuProps';
+import type { TranscriptMoreMenuDebugFlyoutRefs } from './useTranscriptMoreMenuDebugFlyouts';
+import type { DevtoolsDebugFlyoutId } from './devtoolsFlyoutTypes';
+export type TranscriptMoreMenuDevtoolsMenuProps = {
+    transcriptDevtools?: TranscriptDevtoolsMenuProps;
+    micPreset: MicPresetId;
+    onApplyMicPreset?: (preset: MicPresetId) => void;
+    debugFlyout: null | DevtoolsDebugFlyoutId;
+    setDebugFlyout: React.Dispatch<React.SetStateAction<null | DevtoolsDebugFlyoutId>>;
+    refs: TranscriptMoreMenuDebugFlyoutRefs;
+    onCloseMenu: () => void;
+};
+export type TranscriptMoreMenuDevtoolsPortalsProps = Omit<TranscriptMoreMenuDevtoolsMenuProps, 'setDebugFlyout'> & {
+    moreMenuOpen: boolean;
+    flyoutStyle: React.CSSProperties | null;
+    closeFlyout: () => void;
+    usePortal: boolean;
+    ReactDOM?: {
+        createPortal: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
+};
+/** Transcript ⋯ menu rows for mic preset + developer tools (inside the more-menu `<ul>`). */
+export declare function TranscriptMoreMenuDevtools({ transcriptDevtools, micPreset, onApplyMicPreset, debugFlyout, setDebugFlyout, refs, onCloseMenu, }: TranscriptMoreMenuDevtoolsMenuProps): React.JSX.Element | null;
+/** Portaled debug flyouts — mount next to the transcript more menu portal. */
+export declare function TranscriptMoreMenuDevtoolsPortals({ transcriptDevtools, micPreset, onApplyMicPreset, moreMenuOpen, debugFlyout, flyoutStyle, refs, onCloseMenu, closeFlyout, usePortal, ReactDOM, }: TranscriptMoreMenuDevtoolsPortalsProps): React.JSX.Element;

package/dist/devtools/transcriptMoreMenu/devtoolsFlyoutTypes.d.ts

@@ -0,0 +1 @@
+export type DevtoolsDebugFlyoutId = 'logger' | 'micPreset' | 'adminPortal' | 'theme';

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

@@ -0,0 +1,2 @@
+export { TranscriptMoreMenuDevtools, TranscriptMoreMenuDevtoolsPortals, } from './TranscriptMoreMenuDevtools';
+export { useTranscriptMoreMenuDebugFlyouts } from './useTranscriptMoreMenuDebugFlyouts';

package/dist/devtools/transcriptMoreMenu/readWindowGuideAILogger.d.ts

@@ -0,0 +1,12 @@
+import type { LoggerComponentKey } from '../../utils/logger';
+type WindowGuideAILogger = {
+    enable?: () => void;
+    disable?: () => void;
+    getStatus?: () => {
+        manualEnabled: boolean;
+        components: Record<LoggerComponentKey, boolean>;
+    };
+    setComponentEnabled?: (c: LoggerComponentKey, enabled: boolean) => void;
+};
+export declare function readWindowGuideAILogger(): WindowGuideAILogger | undefined;
+export {};

package/dist/devtools/transcriptMoreMenu/useTranscriptMoreMenuDebugFlyouts.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+import type { DevtoolsDebugFlyoutId } from './devtoolsFlyoutTypes';
+export type TranscriptMoreMenuDebugFlyoutRefs = {
+    loggerFlyoutTriggerRef: React.RefObject<HTMLButtonElement>;
+    adminPortalFlyoutTriggerRef: React.RefObject<HTMLButtonElement>;
+    themeFlyoutTriggerRef: React.RefObject<HTMLButtonElement>;
+    micPresetFlyoutTriggerRef: React.RefObject<HTMLButtonElement>;
+    loggerDebugFlyoutListRef: React.RefObject<HTMLUListElement>;
+    adminPortalFlyoutListRef: React.RefObject<HTMLUListElement>;
+    themeFlyoutListRef: React.RefObject<HTMLUListElement>;
+    micPresetFlyoutListRef: React.RefObject<HTMLUListElement>;
+};
+export declare function useTranscriptMoreMenuDebugFlyouts(moreMenuOpen: boolean, moreMenuPlacement: {
+    left: number;
+    bottom: number;
+    minWidth: number;
+} | null): {
+    debugFlyout: DevtoolsDebugFlyoutId | null;
+    setDebugFlyout: React.Dispatch<React.SetStateAction<DevtoolsDebugFlyoutId | null>>;
+    flyoutStyle: React.CSSProperties | null;
+    refs: TranscriptMoreMenuDebugFlyoutRefs;
+    outsideClickRefs: React.RefObject<HTMLUListElement>[];
+    closeFlyout: () => void;
+};