guideai-app 0.5.4-2 → 0.5.4-8

package/dist/GuideAI.js.LICENSE.txt

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

package/dist/buddy/buddyPropTools.d.ts

@@ -0,0 +1,188 @@
+import { executeBuddyMemory, executeBuddyQuickie, executeBuddyResearch, executeBuddyTaskList } from './buddyTools';
+export declare const BUDDY_TOOL_NAMES: readonly ["buddyTaskList", "buddyResearch", "buddyQuickie", "buddyMemory"];
+export declare const buddyPropTools: {
+    buddyTaskList: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                action: {
+                    enum: readonly ["add", "list", "getNext", "complete", "update", "remove"];
+                    type: "string";
+                    description: string;
+                };
+                userId: {
+                    type: "string";
+                    description: string;
+                };
+                title: {
+                    type: "string";
+                    description: string;
+                };
+                description: {
+                    type: "string";
+                    description: string;
+                };
+                taskId: {
+                    type: "string";
+                    description: string;
+                };
+                status: {
+                    type: "string";
+                    enum: readonly ["pending", "in_progress", "completed", "cancelled"];
+                    description: string;
+                };
+                priority: {
+                    type: "string";
+                    enum: readonly ["low", "normal", "high"];
+                    description: string;
+                };
+            };
+            required: readonly ["action"];
+        };
+        execute: typeof executeBuddyTaskList;
+    };
+    buddyResearch: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                action: {
+                    enum: readonly ["add", "list", "get"];
+                    type: "string";
+                    description: string;
+                };
+                userId: {
+                    type: "string";
+                    description: string;
+                };
+                title: {
+                    type: "string";
+                    description: string;
+                };
+                content: {
+                    type: "string";
+                    description: string;
+                };
+                sources: {
+                    type: "array";
+                    items: {
+                        type: "string";
+                    };
+                    description: string;
+                };
+                tags: {
+                    type: "array";
+                    items: {
+                        type: "string";
+                    };
+                    description: string;
+                };
+                taskId: {
+                    type: "string";
+                    description: string;
+                };
+                noteId: {
+                    type: "string";
+                    description: string;
+                };
+                query: {
+                    type: "string";
+                    description: string;
+                };
+            };
+            required: readonly ["action"];
+        };
+        execute: typeof executeBuddyResearch;
+    };
+    buddyQuickie: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                action: {
+                    enum: readonly ["save", "list", "get", "run", "delete"];
+                    type: "string";
+                    description: string;
+                };
+                userId: {
+                    type: "string";
+                    description: string;
+                };
+                quickieId: {
+                    type: "string";
+                    description: string;
+                };
+                name: {
+                    type: "string";
+                    description: string;
+                };
+                description: {
+                    type: "string";
+                    description: string;
+                };
+                trigger: {
+                    type: "string";
+                    description: string;
+                };
+                steps: {
+                    type: "array";
+                    description: string;
+                    items: {
+                        type: "object";
+                        properties: {
+                            kind: {
+                                type: "string";
+                                enum: readonly ["instruction", "tool"];
+                            };
+                            content: {
+                                type: "string";
+                            };
+                        };
+                        required: readonly ["kind", "content"];
+                    };
+                };
+                tags: {
+                    type: "array";
+                    items: {
+                        type: "string";
+                    };
+                    description: string;
+                };
+            };
+            required: readonly ["action"];
+        };
+        execute: typeof executeBuddyQuickie;
+    };
+    buddyMemory: {
+        description: string;
+        parameters: {
+            type: "object";
+            properties: {
+                action: {
+                    enum: readonly ["get", "search", "setNote", "appendOrganization", "appendWorkStyle"];
+                    type: "string";
+                    description: string;
+                };
+                userId: {
+                    type: "string";
+                    description: string;
+                };
+                key: {
+                    type: "string";
+                    description: string;
+                };
+                value: {
+                    type: "string";
+                    description: string;
+                };
+                query: {
+                    type: "string";
+                    description: string;
+                };
+            };
+            required: readonly ["action"];
+        };
+        execute: typeof executeBuddyMemory;
+    };
+};

package/dist/buddy/buddyStore.d.ts

@@ -0,0 +1,88 @@
+import { type BuddyMemory, type BuddyState, type BuddyTask, type BuddyTaskPriority, type BuddyTaskStatus, type Quickie, type QuickieStep, type ResearchNote } from './types';
+export declare const BUDDY_STATE_CHANGED_EVENT = "guideai_buddy_state_changed";
+export declare function resolveBuddyUserId(override?: string): string;
+export declare function readBuddyState(userId?: string): BuddyState;
+export declare function writeBuddyState(state: BuddyState): BuddyState;
+export declare function addBuddyTask(input: {
+    title: string;
+    description?: string;
+    priority?: BuddyTaskPriority;
+    status?: BuddyTaskStatus;
+    userId?: string;
+}): BuddyTask;
+export declare function listBuddyTasks(input?: {
+    status?: BuddyTaskStatus;
+    userId?: string;
+}): BuddyTask[];
+export declare function getNextBuddyTask(userId?: string): BuddyTask | null;
+export declare function updateBuddyTask(input: {
+    taskId: string;
+    title?: string;
+    description?: string;
+    status?: BuddyTaskStatus;
+    priority?: BuddyTaskPriority;
+    userId?: string;
+}): BuddyTask;
+export declare function completeBuddyTask(input: {
+    taskId: string;
+    userId?: string;
+}): BuddyTask;
+export declare function removeBuddyTask(input: {
+    taskId: string;
+    userId?: string;
+}): boolean;
+export declare function addResearchNote(input: {
+    title: string;
+    content: string;
+    sources?: string[];
+    tags?: string[];
+    taskId?: string;
+    userId?: string;
+}): ResearchNote;
+export declare function listResearchNotes(input?: {
+    query?: string;
+    taskId?: string;
+    userId?: string;
+}): ResearchNote[];
+export declare function getResearchNote(input: {
+    noteId: string;
+    userId?: string;
+}): ResearchNote;
+export declare function saveQuickie(input: {
+    name: string;
+    description: string;
+    trigger?: string;
+    steps: QuickieStep[];
+    tags?: string[];
+    quickieId?: string;
+    userId?: string;
+}): Quickie;
+export declare function listQuickies(userId?: string): Quickie[];
+export declare function getQuickie(input: {
+    quickieId: string;
+    userId?: string;
+}): Quickie;
+export declare function runQuickie(input: {
+    quickieId: string;
+    userId?: string;
+}): Quickie;
+export declare function deleteQuickie(input: {
+    quickieId: string;
+    userId?: string;
+}): boolean;
+export declare function getBuddyMemory(userId?: string): BuddyMemory;
+export declare function setBuddyMemoryNote(input: {
+    key: string;
+    value: string;
+    userId?: string;
+}): BuddyMemory;
+export declare function appendBuddyMemoryList(input: {
+    category: 'organization' | 'workStyle';
+    value: string;
+    userId?: string;
+}): BuddyMemory;
+export declare function searchBuddyMemory(input: {
+    query?: string;
+    userId?: string;
+}): BuddyMemory;
+export declare function clearBuddyState(userId?: string): BuddyState;

package/dist/buddy/buddyTools.d.ts

@@ -0,0 +1,6 @@
+type RecordArgs = Record<string, unknown>;
+export declare function executeBuddyTaskList(args: RecordArgs): Promise<unknown>;
+export declare function executeBuddyResearch(args: RecordArgs): Promise<unknown>;
+export declare function executeBuddyQuickie(args: RecordArgs): Promise<unknown>;
+export declare function executeBuddyMemory(args: RecordArgs): Promise<unknown>;
+export {};

package/dist/buddy/types.d.ts

@@ -0,0 +1,56 @@
+export type BuddyTaskStatus = 'pending' | 'in_progress' | 'completed' | 'cancelled';
+export type BuddyTaskPriority = 'low' | 'normal' | 'high';
+export type BuddyTask = {
+    id: string;
+    title: string;
+    description?: string;
+    status: BuddyTaskStatus;
+    priority: BuddyTaskPriority;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+    relatedResearchIds?: string[];
+};
+export type ResearchNote = {
+    id: string;
+    title: string;
+    content: string;
+    sources?: string[];
+    tags?: string[];
+    taskId?: string;
+    createdAt: string;
+    updatedAt: string;
+};
+export type QuickieStepKind = 'instruction' | 'tool';
+export type QuickieStep = {
+    kind: QuickieStepKind;
+    content: string;
+};
+export type Quickie = {
+    id: string;
+    name: string;
+    description: string;
+    trigger?: string;
+    steps: QuickieStep[];
+    tags?: string[];
+    usageCount: number;
+    lastUsedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+};
+export type BuddyMemory = {
+    organization: string[];
+    workStyle: string[];
+    notes: Record<string, string>;
+    updatedAt: string;
+};
+export type BuddyState = {
+    version: 1;
+    userId: string;
+    tasks: BuddyTask[];
+    research: ResearchNote[];
+    quickies: Quickie[];
+    memory: BuddyMemory;
+};
+export declare const BUDDY_STATE_VERSION: 1;
+export declare const EMPTY_BUDDY_MEMORY: BuddyMemory;

package/dist/components/DeveloperTools.d.ts

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

package/dist/components/Microphone.d.ts

@@ -1,11 +1,26 @@
-import { PopupPosition, RecordingStatus } from '../types/GuideAI.types';
+import { GuideAILauncherTabSide, GuideAILauncherVariant, PopupPosition, RecordingStatus } from '../types/GuideAI.types';
 interface MicrophoneProps {
     componentRef: React.RefObject<HTMLDivElement>;
     baseStyles: React.CSSProperties;
     popupPosition: PopupPosition;
+    /** `mic` (default): floating circle. `tab`: edge-docked draggable tab — same behavior, different shell. */
+    launcherVariant?: GuideAILauncherVariant;
+    /** Tab variant only — screen edge the tab docks to (default `right`). */
+    launcherTabSide?: GuideAILauncherTabSide;
+    /** Tab variant only — localStorage scope for the persisted drag offset. */
+    launcherTabPrefsKey?: string;
     showOnboarding: boolean;
     handleOnboardingComplete: () => void;
     handleOnboardingClose: () => void;
+    sessionRatingVisible: boolean;
+    sessionRatingClosing: boolean;
+    sessionRatingTitle: string;
+    sessionRatingComment: string;
+    sessionRatingShowCommentField: boolean;
+    onSessionRatingCommentChange: (value: string) => void;
+    onSessionRatingTellUsMore: () => void;
+    onSessionRating: (stars: number) => void;
+    onSessionRatingDismiss: () => void;
     isConnecting: boolean;
     connectionMessage?: string | null;
     status: RecordingStatus;
@@ -17,5 +32,5 @@ interface MicrophoneProps {
     hasInteracted: boolean;
     React: typeof import('react');
 }
-declare const Microphone: ({ componentRef, baseStyles, popupPosition, showOnboarding, handleOnboardingComplete, handleOnboardingClose, isConnecting, connectionMessage, status, handleToggleConversation, showTranscript, hasMic, isMuted, hasInteracted, React, }: MicrophoneProps) => import("react").JSX.Element;
+declare const Microphone: ({ componentRef, baseStyles, popupPosition, launcherVariant, launcherTabSide, launcherTabPrefsKey, showOnboarding, handleOnboardingComplete, handleOnboardingClose, sessionRatingVisible, sessionRatingClosing, sessionRatingTitle, sessionRatingComment, sessionRatingShowCommentField, onSessionRatingCommentChange, onSessionRatingTellUsMore, onSessionRating, onSessionRatingDismiss, isConnecting, connectionMessage, status, handleToggleConversation, showTranscript, hasMic, isMuted, hasInteracted, React, }: MicrophoneProps) => import("react").JSX.Element;
 export default Microphone;

package/dist/components/PlaybackLockDebugOverlayRoot.d.ts

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

package/dist/components/SessionRatingPopup.d.ts

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

package/dist/components/SubtitleInputBar.d.ts

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

package/dist/components/SubtitleSettingsMenu.d.ts

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

package/dist/components/TranscriptBox.d.ts

@@ -1,10 +1,13 @@
 import { StoredMessage } from '../utils/messageStorage';
+import type { SilentDebugMessage } from '../devtools/silentMessages/silentMessageDebug';
 import { TranscriptPanelMode, TranscriptPosition, MicButtonPosition, TranscriptSessionMode, RecordingStatus } from '../types/GuideAI.types';
 import { type StubWorkflowItem, type StubWorkspaceOption } from '../stubs/workspaces';
-import type { WorkspaceDataSource } from '../utils/localStorageHelper';
+import type { TranscriptDevtoolsMenuProps } from '../devtools/transcriptDevtoolsMenuProps';
 import type { MicPresetId } from '../types/audioConfig.types';
 interface TranscriptBoxProps {
     allMessages: StoredMessage[];
+    /** Devtools "Show silent messages": hidden LLM sends shown inline in the transcript. */
+    silentMessages?: SilentDebugMessage[];
     showTranscript: boolean;
     fileDropTargetActive?: boolean;
     transcriptFileDropAllowed?: boolean;
@@ -13,6 +16,8 @@ interface TranscriptBoxProps {
     onTranscriptFileDrop?: (file: File) => void;
     /** Tear down WebRTC, clear session, return to mic — toolbar X only (footer status control toggles mute). */
     onEndSession?: () => void;
+    /** Footer "Next" bar button: inject a silent "What's next?" note and request a reply. */
+    onSendWhatsNext?: () => void;
     recordingStatus?: RecordingStatus;
     isConnecting?: boolean;
     showTextInput?: boolean;
@@ -34,14 +39,9 @@ interface TranscriptBoxProps {
     handleResetChat?: () => void;
     isDataChannelOpen?: boolean;
     isResponseActive?: boolean;
-    /** Console: GuideAI.debug.showMoreMenu() — extra ⋯ menu rows for developers. */
-    debugMoreMenuEnabled?: boolean;
-    /** Transcript ⋯ → Debug: show/hide unified developer tools. */
-    developerToolsMenu?: {
-        shellOpen: boolean;
-        onToggleShell: () => void;
-    } | null;
-    /** Current mic preset (Precise / Noisy); shown in ⋯ flyout when debug menu is on. */
+    /** Transcript ⋯ developer tools menu + embed unlock (toolbar title triple-click). */
+    transcriptDevtools?: TranscriptDevtoolsMenuProps;
+    /** Current mic preset (Precise / Noisy); shown in ⋯ when developer tools menu is on. */
     micPreset?: MicPresetId;
     /** Apply preset from transcript menu: persist, reset stored audio to preset base, live session.update. */
     onApplyMicPreset?: (preset: MicPresetId) => void;
@@ -55,18 +55,22 @@ interface TranscriptBoxProps {
      */
     transcriptPanelMode?: TranscriptPanelMode;
     onToggleTranscriptPanelMode?: () => void;
+    /** Switch float panel to docked (e.g. drag past the right viewport edge). */
+    onDockTranscriptPanel?: () => void;
+    /** Switch docked panel to float (e.g. drag away from the right edge). */
+    onUndockTranscriptPanel?: () => void;
     transcriptSessionMode?: TranscriptSessionMode;
     onTranscriptSessionModeChange?: (mode: TranscriptSessionMode) => void;
     /** Stub list until API-driven; computed once in GuideAI. */
     workspaceOptions: StubWorkspaceOption[];
-    /** Debug ⋯: stub vs API workspace data (toggle writes localStorage). */
-    workspaceDataSource: WorkspaceDataSource;
-    /** Workflow steps for the current workspace; from stubs or future API. */
+    /** Workflow steps for the current workspace from the API catalog. */
     workspaceWorkflows: StubWorkflowItem[];
     workflowDrawerOpen?: boolean;
     onWorkflowDrawerOpenChange: (open: boolean) => void;
     /** Access-key realtime: notify parent of DB workflow id for next initialize (workspace prompt + this step). Label used for rollup silent steer. */
     onSessionWorkflowForRealtimeInit?: (workflowId: string | null, workflowLabel?: string) => void;
+    /** Namespace for sticky workflow prefs (`guideAI_transcriptWorkflowState`). */
+    conversationKey?: string;
     /** Docked drawer width (px); persisted by parent when `onDrawerWidthChange` is used. */
     drawerWidthPx?: number;
     onDrawerWidthChange?: (widthPx: number) => void;

package/dist/components/TranscriptMessages.d.ts

@@ -1,6 +1,7 @@
 import { StoredMessage } from '../utils/messageStorage';
 import type { StubWorkspaceOption } from '../stubs/workspaces';
 import type { TranscriptSessionMode } from '../types/GuideAI.types';
+import type { SilentDebugMessage } from '../devtools/silentMessages/silentMessageDebug';
 interface TranscriptMessagesProps {
     allMessages: StoredMessage[];
     messagesEndRef: React.RefObject<HTMLDivElement>;
@@ -9,7 +10,13 @@ interface TranscriptMessagesProps {
     workspaceOptions?: StubWorkspaceOption[];
     selectedWorkspaceId?: TranscriptSessionMode;
     onSelectWorkspace?: (mode: TranscriptSessionMode) => void;
+    /** Devtools "Show silent messages": hidden LLM sends interleaved by timestamp. */
+    silentMessages?: SilentDebugMessage[];
+    /** Portal target for the silent-message detail dialog (matches transcript menus). */
+    ReactDOM?: {
+        createPortal: (children: React.ReactNode, container: Element) => React.ReactNode;
+    };
     React: typeof import('react');
 }
-declare const TranscriptMessages: ({ allMessages, messagesEndRef, docFormProgress, workspaceSelectorPosted, workspaceOptions, selectedWorkspaceId, onSelectWorkspace, React, }: TranscriptMessagesProps) => import("react").JSX.Element;
+declare const TranscriptMessages: ({ allMessages, messagesEndRef, docFormProgress, workspaceSelectorPosted, workspaceOptions, selectedWorkspaceId, onSelectWorkspace, silentMessages, ReactDOM, React, }: TranscriptMessagesProps) => import("react").JSX.Element;
 export default TranscriptMessages;

package/dist/components/TranscriptNextStepBar.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+import type { RecordingStatus } from '../types/GuideAI.types';
+/** Idle time before the tab slides into view once all activity stops (ms). */
+export declare const NEXT_BAR_IDLE_DELAY_MS = 3000;
+/**
+ * Conversation statuses that count as activity for the "Next" tab: the user speaking
+ * (`active`), work in flight (`processing`), and assistant audio playing (`playing`).
+ * `recording` (listening, no speech) and `idle` are quiet — the user may need a nudge.
+ */
+export declare function isConversationQuiet(status: RecordingStatus | undefined): boolean;
+export interface TranscriptNextStepBarProps {
+    /**
+     * No activity of any kind: data channel open, no reply in flight, and the conversation
+     * quiet per {@link isConversationQuiet} (no user speech / assistant audio). The tab
+     * slides in 3s after this becomes true.
+     */
+    available: boolean;
+    /** Inject a silent "What's next?" note and request a reply. */
+    onNext: () => void;
+}
+/**
+ * "Next" tab that slides up from the input row's top edge, right-aligned. It is a nudge for
+ * users who have stalled: hidden by default and during any activity (user speaking, reply in
+ * flight, assistant audio), it slides into view after 3s of inactivity and slides away when
+ * clicked or when activity resumes, staying hidden until the conversation goes quiet again.
+ *
+ * Styling lives in `guideAIStylesTranscript.ts` and must use `--guideai-t-*` theme tokens
+ * so the tab follows the active theme preset — see docs/THEMES.md ("Theming new UI").
+ */
+declare const TranscriptNextStepBar: {
+    ({ available, onNext }: TranscriptNextStepBarProps): React.JSX.Element;
+    displayName: string;
+};
+export default TranscriptNextStepBar;

package/dist/components/TranscriptSessionMicLevels.d.ts

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