guideai-app 0.5.4-2 → 0.5.4-8

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;

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>;