@promptbook/node 0.113.0-8 → 0.114.0-0

package/esm/src/book-components/BookEditor/useBookEditorMonacoUploads.d.ts

@@ -1,62 +1,10 @@
 import type { editor } from 'monaco-editor';
-import type { Promisable } from 'type-fest';
+import type { BookEditorMonacoOnFileUpload } from './useBookEditorMonacoUploads/bookEditorMonacoUploadTypes';
+export type { UploadItem, UploadStats } from './useBookEditorMonacoUploads/bookEditorMonacoUploadTypes';
 /**
  * Type describing monaco editor.
  */
 type MonacoEditor = typeof import('monaco-editor');
-/**
- * Type describing upload status.
- */
-type UploadStatus = 'queued' | 'uploading' | 'paused' | 'completed' | 'failed';
-/**
- * Type describing upload item.
- */
-export type UploadItem = {
-    readonly id: string;
-    readonly fileName: string;
-    readonly fileSize: number;
-    readonly status: UploadStatus;
-    readonly progress: number;
-    readonly loadedBytes: number;
-    readonly totalBytes: number;
-    readonly startedAt: number | null;
-    readonly completedAt: number | null;
-    readonly errorMessage?: string;
-};
-/**
- * Type describing upload stats.
- */
-export type UploadStats = {
-    readonly totalFiles: number;
-    readonly queuedFiles: number;
-    readonly uploadingFiles: number;
-    readonly pausedFiles: number;
-    readonly failedFiles: number;
-    readonly completedFiles: number;
-    readonly totalBytes: number;
-    readonly uploadedBytes: number;
-    readonly progress: number;
-    readonly elapsedMs: number;
-    readonly speedBytesPerSecond: number;
-};
-/**
- * Type describing book editor monaco upload progress callback.
- */
-type BookEditorMonacoUploadProgressCallback = (progress: number, stats?: {
-    loadedBytes: number;
-    totalBytes: number;
-}) => void;
-/**
- * Options for book editor monaco upload.
- */
-type BookEditorMonacoUploadOptions = {
-    readonly onProgress?: BookEditorMonacoUploadProgressCallback;
-    readonly abortSignal?: AbortSignal;
-};
-/**
- * Type describing book editor monaco on file upload.
- */
-type BookEditorMonacoOnFileUpload = (file: File, options?: BookEditorMonacoUploadOptions | BookEditorMonacoUploadProgressCallback) => Promisable<string>;
 /**
  * Props for use book editor monaco uploads.
  */
@@ -71,11 +19,10 @@ type UseBookEditorMonacoUploadsProps = {
  * @private function of BookEditorMonaco
  */
 export declare function useBookEditorMonacoUploads({ editor, monaco, onFileUpload }: UseBookEditorMonacoUploadsProps): {
-    activeUploadItems: UploadItem[];
-    uploadItems: UploadItem[];
-    uploadStats: UploadStats;
+    activeUploadItems: import("./useBookEditorMonacoUploads/bookEditorMonacoUploadTypes").UploadItem[];
+    uploadItems: import("./useBookEditorMonacoUploads/bookEditorMonacoUploadTypes").UploadItem[];
+    uploadStats: import("./useBookEditorMonacoUploads/bookEditorMonacoUploadTypes").UploadStats;
     handleFiles: (files: File[]) => Promise<void>;
     pauseUpload: (uploadId: string) => void;
     resumeUpload: (uploadId: string) => void;
 };
-export {};

package/esm/src/book-components/Chat/Chat/ChatCitationModal.d.ts

@@ -13,6 +13,11 @@ export type ChatCitationModalProps = {
     participants: ReadonlyArray<ChatParticipant>;
     resolveCitationLabel?: CitationLabelResolver;
     soundSystem?: ChatSoundSystem;
+    /**
+     * Optional agent identifier (name or permanent id) scoping the live browser fallback
+     * to the agent's persistent server-side browser profile.
+     */
+    agentIdentifier?: string;
     onClose: () => void;
 };
 /**

package/esm/src/book-components/Chat/Chat/ChatCitationModal.test.d.ts

@@ -0,0 +1,2 @@
+/** @jest-environment jsdom */
+export {};

package/esm/src/book-components/Chat/Chat/ChatFeedbackStar.d.ts

@@ -0,0 +1,37 @@
+import type { MouseEventHandler } from 'react';
+/**
+ * Star values available in the chat feedback UI.
+ *
+ * @private constant of `<Chat/>`
+ */
+export declare const CHAT_FEEDBACK_STAR_RATINGS: readonly [1, 2, 3, 4, 5];
+/**
+ * Props for the shared chat feedback star icon.
+ *
+ * @private type of `<Chat/>`
+ */
+type ChatFeedbackStarProps = {
+    readonly isActive: boolean;
+    readonly inactiveColor: string;
+    readonly className?: string;
+    readonly onClick?: MouseEventHandler<HTMLSpanElement>;
+    readonly onMouseEnter?: MouseEventHandler<HTMLSpanElement>;
+    readonly onMouseLeave?: MouseEventHandler<HTMLSpanElement>;
+};
+/**
+ * Resolves the inactive color for stars in the feedback controls.
+ *
+ * @param mode Current chat color mode.
+ * @param tone Visual weight for the inactive star.
+ * @returns Hex color for an inactive star.
+ *
+ * @private function of `<Chat/>`
+ */
+export declare function resolveChatFeedbackStarInactiveColor(mode: 'LIGHT' | 'DARK', tone?: 'subtle' | 'muted'): "#888" | "#666" | "#ccc" | "#555";
+/**
+ * Renders one CSS-colored feedback star.
+ *
+ * @private component of `<Chat/>`
+ */
+export declare function ChatFeedbackStar({ isActive, inactiveColor, className, onClick, onMouseEnter, onMouseLeave, }: ChatFeedbackStarProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/esm/src/book-components/Chat/Chat/ChatImageAttachmentModal.d.ts

@@ -0,0 +1,25 @@
+/// <reference types="react" />
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * One attachment payload displayed by the chat image preview modal.
+ *
+ * @private type of `<ChatImageAttachmentModal/>`
+ */
+type ChatImageAttachment = NonNullable<ChatMessage['attachments']>[number];
+/**
+ * Props for the chat image attachment preview modal.
+ *
+ * @private props of `<ChatImageAttachmentModal/>`
+ */
+type ChatImageAttachmentModalProps = {
+    readonly attachment: ChatImageAttachment | null;
+    readonly mode?: 'LIGHT' | 'DARK';
+    readonly onClose: () => void;
+};
+/**
+ * Modal that previews an image attachment without leaving the chat surface.
+ *
+ * @private component of `<Chat/>`
+ */
+export declare function ChatImageAttachmentModal({ attachment, mode, onClose }: ChatImageAttachmentModalProps): import("react").ReactPortal | null;
+export {};

package/esm/src/book-components/Chat/Chat/ChatInputArea.d.ts

@@ -4,6 +4,7 @@ import type { WithTake } from '../../../utils/take/interfaces/ITakeChain';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
 import type { ChatProps, ChatSoundSystem } from './ChatProps';
+import type { ChatComposerDraft } from './useChatInputAreaComposer';
 /**
  * Wrapper for consistent button-click sound handling.
  *
@@ -22,6 +23,7 @@ export type ChatInputAreaProps = {
     speechRecognition?: ChatProps['speechRecognition'];
     speechRecognitionLanguage?: ChatProps['speechRecognitionLanguage'];
     defaultMessage?: string;
+    draftMessage?: ChatComposerDraft;
     replyingToMessage?: ChatMessage | null;
     onCancelReply?: ChatProps['onCancelReply'];
     enterBehavior?: ChatProps['enterBehavior'];
@@ -36,6 +38,7 @@ export type ChatInputAreaProps = {
     onButtonClick: ChatInputButtonClickHandler;
     chatInputClassName?: string;
     chatUiTranslations?: ChatProps['chatUiTranslations'];
+    mode?: 'LIGHT' | 'DARK';
 };
 /**
  * Renders the chat input area with text, file upload, and voice controls.

package/esm/src/book-components/Chat/Chat/ChatMessageAttachments.d.ts

@@ -0,0 +1,27 @@
+import { type CSSProperties } from 'react';
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * One uploaded file attached to a chat message.
+ *
+ * @private type of `<Chat/>`
+ */
+export type ChatMessageAttachment = NonNullable<ChatMessage['attachments']>[number];
+/**
+ * Props accepted by the shared attachment chip list.
+ *
+ * @private props of `<Chat/>`
+ */
+type ChatMessageAttachmentsProps = {
+    readonly attachments: ReadonlyArray<ChatMessageAttachment>;
+    readonly mode: 'LIGHT' | 'DARK';
+    readonly className?: string;
+    readonly style?: CSSProperties;
+    readonly onRemoveAttachment?: (attachment: ChatMessageAttachment, attachmentIndex: number) => void;
+};
+/**
+ * Renders chat attachment chips and the shared image preview modal.
+ *
+ * @private component of `<Chat/>`
+ */
+export declare function ChatMessageAttachments({ attachments, mode, className, style, onRemoveAttachment, }: ChatMessageAttachmentsProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/esm/src/book-components/Chat/Chat/ChatMessageItem.d.ts

@@ -9,7 +9,7 @@ import type { ChatProps } from './ChatProps';
  *
  * @private props for internal subcomponent
  */
-type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'onActionButton' | 'onQuickMessageButton' | 'participants'> & {
+type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'onActionButton' | 'onQuickMessageButton' | 'onQuickMessageDraftButton' | 'participants'> & {
     message: ChatMessage;
     participant: ChatParticipant | undefined;
     isLastMessage: boolean;
@@ -76,6 +76,10 @@ type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'onActionButton' | 'on
      * Optional cached metadata keyed by TEAM tool names to enrich tool call chips.
      */
     teamAgentProfiles?: ChatProps['teamAgentProfiles'];
+    /**
+     * Optional inline references rendered from `[[reference]]` tokens in message markdown.
+     */
+    markdownInlineReferences?: ChatProps['markdownInlineReferences'];
     /**
      * Controls whether assistant replies render as bubbles or article blocks.
      */

package/esm/src/book-components/Chat/Chat/ChatMessageList.d.ts

@@ -44,12 +44,17 @@ export type ChatMessageListProps = {
     onMessage?: (messageContent: string) => Promisable<void>;
     onActionButton?: ChatProps['onActionButton'];
     onQuickMessageButton?: ChatProps['onQuickMessageButton'];
+    onQuickMessageDraftButton?: ChatProps['onQuickMessageDraftButton'];
     onReplyToMessage?: ChatProps['onReplyToMessage'];
     canReplyToMessage?: ChatProps['canReplyToMessage'];
     onCreateAgent?: (bookContent: string) => void;
     toolTitles?: Record<string, string>;
     teammates?: ChatProps['teammates'];
     teamAgentProfiles?: ChatProps['teamAgentProfiles'];
+    /**
+     * Optional inline references rendered from `[[reference]]` tokens in message markdown.
+     */
+    markdownInlineReferences?: ChatProps['markdownInlineReferences'];
     visualMode?: ChatProps['visualMode'];
     onToolCallClick?: (toolCall: NonNullable<ChatMessage['toolCalls']>[number]) => void;
     onCitationClick?: (citation: ParsedCitation) => void;

package/esm/src/book-components/Chat/Chat/ChatMessageRichContent.d.ts

@@ -1,4 +1,5 @@
 import type { ChatMessage } from '../types/ChatMessage';
+import type { MarkdownInlineReference } from '../utils/renderMarkdown';
 import type { ChatMessageContentSegment } from '../utils/splitMessageContentIntoSegments';
 import type { StreamingFeaturePlaceholderKind } from './StreamingFeaturePlaceholder';
 /**
@@ -23,6 +24,10 @@ export type ChatMessageRichContentProps = {
      * Optional callback for creating a new agent from a book code block.
      */
     readonly onCreateAgent?: (bookContent: string) => void;
+    /**
+     * Optional inline references rendered from `[[reference]]` tokens in message markdown.
+     */
+    readonly markdownInlineReferences?: ReadonlyArray<MarkdownInlineReference>;
     /**
      * Resolved theme used by nested code blocks and editors.
      */

package/esm/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -10,6 +10,7 @@ import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
 import type { CitationLabelResolver } from '../types/CitationLabelResolver';
 import type { ChatSaveFormatHandlerMap } from '../save/_common/ChatSaveFormatHandler';
+import type { MarkdownInlineReference } from '../utils/renderMarkdown';
 /**
  * Response data returned by the optional `onFeedback` handler.
  *
@@ -440,6 +441,14 @@ export type ChatProps = {
      * The title of the chat
      */
     readonly title?: string;
+    /**
+     * Optional identifier (name or permanent id) of the agent owning this chat.
+     *
+     * When set, server-side live browser previews opened from the chat (for example from
+     * knowledge citation chips) run inside the agent's persistent browser profile, so logins
+     * performed by the user in the live session are saved for the agent's future browsing.
+     */
+    readonly agentIdentifier?: string;
     /**
      * Messages to render - they are rendered as they are
      */
@@ -474,6 +483,14 @@ export type ChatProps = {
      * When not provided, quick message buttons fall back to `onMessage`.
      */
     onQuickMessageButton?(messageContent: string): Promisable<void>;
+    /**
+     * Called when user clicks a quick draft-message button parsed from message markdown.
+     *
+     * Unlike `onQuickMessageButton`, this prefills the composer with an editable draft
+     * instead of sending the message. When not provided, `<Chat/>` prefills its own
+     * composer so the draft can be edited before sending.
+     */
+    onQuickMessageDraftButton?(messageDraftContent: string): Promisable<void>;
     /**
      * Optional callback fired when the user starts replying to one existing message.
      */
@@ -677,6 +694,10 @@ export type ChatProps = {
      * Optional cached agent metadata keyed by TEAM tool names to improve chip rendering.
      */
     readonly teamAgentProfiles?: Record<string, AgentChipData>;
+    /**
+     * Optional inline references rendered from `[[reference]]` tokens in message markdown.
+     */
+    readonly markdownInlineReferences?: ReadonlyArray<MarkdownInlineReference>;
     /**
      * Optional callback to create a new agent from the template.
      * If provided, renders the [Create Agent] button for book code blocks.

package/esm/src/book-components/Chat/Chat/ChatRatingModal.test.d.ts

@@ -0,0 +1,2 @@
+/** @jest-environment jsdom */
+export {};

package/esm/src/book-components/Chat/Chat/CitationIframePreview.d.ts

@@ -6,10 +6,33 @@
 export type CitationIframePreviewProps = {
     src: string;
     title: string;
+    /**
+     * Optional agent identifier (name or permanent id) scoping the live browser fallback
+     * to the agent's persistent server-side browser profile.
+     */
+    agentIdentifier?: string;
+    /**
+     * Optional close handler passed to the live browser toolbar when the preview fills a modal.
+     */
+    onClose?: () => void;
+    /**
+     * Reports whether the URL is embedded directly or shown through the live browser fallback.
+     */
+    onStatusChange?: (status: CitationIframePreviewStatus) => void;
+    /**
+     * Initial preview status used when the parent already knows the resolved mode.
+     */
+    initialStatus?: CitationIframePreviewStatus;
 };
+/**
+ * Internal status of the iframe embed check.
+ *
+ * @private type of `<CitationIframePreview/>`
+ */
+export type CitationIframePreviewStatus = 'loading' | 'embed' | 'browser-stream';
 /**
  * Renders a citation URL preview as an iframe when the target page allows embedding,
- * or falls back to a live server-side browser stream with an "Open in new tab" link
+ * or falls back to an interactive live server-side browser session (`<LiveBrowserPreview/>`)
  * when it does not (e.g. X-Frame-Options: DENY / SAMEORIGIN).
  *
  * Embedding capability is determined by `GET /api/page-preview/check?url=<url>`.
@@ -17,4 +40,4 @@ export type CitationIframePreviewProps = {
  *
  * @private component of `<ChatCitationModal/>`
  */
-export declare function CitationIframePreview({ src, title }: CitationIframePreviewProps): import("react/jsx-runtime").JSX.Element;
+export declare function CitationIframePreview({ src, title, agentIdentifier, onClose, onStatusChange, initialStatus, }: CitationIframePreviewProps): import("react/jsx-runtime").JSX.Element;

package/esm/src/book-components/Chat/Chat/pagePreview/LiveBrowserPreview.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Props of the live browser preview.
+ *
+ * @private component of `<ChatCitationModal/>`
+ */
+export type LiveBrowserPreviewProps = {
+    /**
+     * URL opened in the remote headless browser.
+     */
+    readonly src: string;
+    /**
+     * Human-readable title of the previewed source.
+     */
+    readonly title: string;
+    /**
+     * Optional agent identifier (name or permanent id).
+     *
+     * When set, the live session runs inside the agent's persistent server-side browser profile,
+     * so actions like logging into a website are saved for the agent's future browsing.
+     */
+    readonly agentIdentifier?: string;
+    /**
+     * Optional close handler for modal-hosted previews.
+     */
+    readonly onClose?: () => void;
+};
+/**
+ * Remote-desktop-like live preview of one server-side headless browser session.
+ *
+ * Renders the MJPEG stream of the Agents Server page-preview route and forwards natural
+ * browser interactions to it — hovering, clicking, double-clicking, dragging and text
+ * selection (raw pointer presses with click counts), scrolling, typing and keyboard
+ * shortcuts. A browser-like toolbar adds history navigation, an editable address bar,
+ * local zoom (Ctrl+wheel or buttons), and a full screen mode. The remote viewport follows
+ * the size of the preview area, so the page is always rendered at the size the user sees.
+ *
+ * @private component of `<ChatCitationModal/>`
+ */
+export declare function LiveBrowserPreview({ src, title, agentIdentifier, onClose }: LiveBrowserPreviewProps): import("react/jsx-runtime").JSX.Element;

package/esm/src/book-components/Chat/Chat/pagePreview/LiveBrowserPreview.test.d.ts

@@ -0,0 +1,2 @@
+/** @jest-environment jsdom */
+export {};

package/esm/src/book-components/Chat/Chat/pagePreview/LiveBrowserPreviewToolbar.d.ts

@@ -0,0 +1,71 @@
+import type { PagePreviewNavigationAction } from './PagePreviewInputEvent';
+/**
+ * Props of the live browser preview toolbar.
+ *
+ * @private component of `<LiveBrowserPreview/>`
+ */
+export type LiveBrowserPreviewToolbarProps = {
+    /**
+     * URL shown in the address input (either the user's draft or the remote page URL).
+     */
+    readonly displayedUrl: string;
+    /**
+     * URL of the remote page used by the "Open in new tab" link.
+     */
+    readonly externalUrl: string;
+    /**
+     * Whether the remote browser can navigate back, `null` when unknown.
+     */
+    readonly canGoBack: boolean | null;
+    /**
+     * Whether the remote browser can navigate forward, `null` when unknown.
+     */
+    readonly canGoForward: boolean | null;
+    /**
+     * Current local zoom level (`1` = 100%).
+     */
+    readonly zoomLevel: number;
+    /**
+     * Whether the preview is currently in full screen mode.
+     */
+    readonly isFullscreen: boolean;
+    /**
+     * Sends one history navigation to the remote browser.
+     */
+    readonly onNavigate: (action: PagePreviewNavigationAction) => void;
+    /**
+     * Updates the address-input draft, `null` restores the live remote URL.
+     */
+    readonly onUrlDraftChange: (draft: string | null) => void;
+    /**
+     * Navigates the remote browser to the submitted address.
+     */
+    readonly onUrlSubmit: (url: string) => void;
+    /**
+     * Zooms the local preview in.
+     */
+    readonly onZoomIn: () => void;
+    /**
+     * Zooms the local preview out.
+     */
+    readonly onZoomOut: () => void;
+    /**
+     * Resets the local preview zoom to 100%.
+     */
+    readonly onZoomReset: () => void;
+    /**
+     * Toggles the full screen mode of the preview.
+     */
+    readonly onToggleFullscreen: () => void;
+    /**
+     * Optional close handler shown when the preview fills a modal dialog.
+     */
+    readonly onClose?: () => void;
+};
+/**
+ * Browser-like toolbar of the live page preview with history navigation, an editable
+ * address bar, local zoom controls, full screen toggle, and an "Open in new tab" link.
+ *
+ * @private component of `<LiveBrowserPreview/>`
+ */
+export declare function LiveBrowserPreviewToolbar(props: LiveBrowserPreviewToolbarProps): import("react/jsx-runtime").JSX.Element;

package/esm/src/book-components/Chat/Chat/pagePreview/PagePreviewInputEvent.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Pointer button forwarded from the client to the live page-preview browser.
+ *
+ * @private type shared between `<LiveBrowserPreview/>` and the Agents Server page-preview routes
+ */
+export type PagePreviewPointerButton = 'left' | 'middle' | 'right';
+/**
+ * Browser-history action forwarded from the preview toolbar.
+ *
+ * @private type shared between `<LiveBrowserPreview/>` and the Agents Server page-preview routes
+ */
+export type PagePreviewNavigationAction = 'back' | 'forward' | 'reload';
+/**
+ * One remote-control event forwarded from the live page-preview client to the headless browser.
+ *
+ * Pointer coordinates are expressed as ratios of the streamed viewport (`0` to `1`), so the client
+ * does not need to know the exact remote viewport size.
+ *
+ * - `move` — hover / pointer movement
+ * - `down` / `up` — raw pointer press and release (drag, text selection, double-click via `clickCount`)
+ * - `click` — legacy single click kept for backward compatibility with older preview clients
+ * - `wheel` — scrolling
+ * - `keydown` / `keyup` — keyboard typing and shortcuts, `key` uses `KeyboardEvent.key` values
+ * - `resize` — the client preview area changed, the remote viewport should follow
+ * - `navigate` — browser-history navigation from the preview toolbar
+ * - `goto` — navigate to one absolute HTTP(S) URL from the preview toolbar
+ *
+ * @private type shared between `<LiveBrowserPreview/>` and the Agents Server page-preview routes
+ */
+export type PagePreviewInputEvent = {
+    readonly type: 'move';
+    readonly xRatio: number;
+    readonly yRatio: number;
+} | {
+    readonly type: 'down';
+    readonly xRatio: number;
+    readonly yRatio: number;
+    readonly button: PagePreviewPointerButton;
+    readonly clickCount: number;
+} | {
+    readonly type: 'up';
+    readonly xRatio: number;
+    readonly yRatio: number;
+    readonly button: PagePreviewPointerButton;
+    readonly clickCount: number;
+} | {
+    readonly type: 'click';
+    readonly xRatio: number;
+    readonly yRatio: number;
+} | {
+    readonly type: 'wheel';
+    readonly xRatio: number;
+    readonly yRatio: number;
+    readonly deltaX: number;
+    readonly deltaY: number;
+} | {
+    readonly type: 'keydown';
+    readonly key: string;
+} | {
+    readonly type: 'keyup';
+    readonly key: string;
+} | {
+    readonly type: 'resize';
+    readonly width: number;
+    readonly height: number;
+} | {
+    readonly type: 'navigate';
+    readonly action: PagePreviewNavigationAction;
+} | {
+    readonly type: 'goto';
+    readonly url: string;
+};

package/esm/src/book-components/Chat/Chat/pagePreview/PagePreviewInputQueue.d.ts

@@ -0,0 +1,64 @@
+import type { PagePreviewInputEvent } from './PagePreviewInputEvent';
+import type { PagePreviewSessionState } from './PagePreviewSessionState';
+/**
+ * Options of one `PagePreviewInputQueue`.
+ *
+ * @private type of `PagePreviewInputQueue`
+ */
+export type PagePreviewInputQueueOptions = {
+    /**
+     * Page-preview browser session id the events belong to.
+     */
+    readonly sessionId: string;
+    /**
+     * Endpoint receiving the input events, defaults to `/api/page-preview/input`.
+     */
+    readonly endpointUrl?: string;
+    /**
+     * Called with the fresh session navigation state returned by the server after each delivered event.
+     */
+    readonly onSessionState?: (state: PagePreviewSessionState) => void;
+};
+/**
+ * Delivers remote-control events of one live page-preview browser session to the Agents Server.
+ *
+ * Events are sent strictly one after another so the remote browser receives them in order
+ * (crucial for drags and text selection). While one request is in flight, bursty events are
+ * coalesced: consecutive `move` events collapse into the latest one, consecutive `wheel`
+ * events accumulate their deltas, and only the latest `resize` is kept.
+ *
+ * @private utility of `<LiveBrowserPreview/>`
+ */
+export declare class PagePreviewInputQueue {
+    private readonly options;
+    private readonly pendingEvents;
+    private isFlushing;
+    private isDisposed;
+    constructor(options: PagePreviewInputQueueOptions);
+    /**
+     * Enqueues one input event for ordered delivery.
+     *
+     * @param inputEvent - Event to forward to the remote browser.
+     */
+    send(inputEvent: PagePreviewInputEvent): void;
+    /**
+     * Stops the queue and drops all undelivered events.
+     */
+    dispose(): void;
+    /**
+     * Adds one event to the queue, merging it with the trailing event when possible.
+     *
+     * @param inputEvent - Event to enqueue.
+     */
+    private coalesceIntoPendingEvents;
+    /**
+     * Delivers pending events one by one until the queue is drained.
+     */
+    private flushPendingEvents;
+    /**
+     * Sends one event to the server, surfacing the returned session state.
+     *
+     * @param inputEvent - Event to deliver.
+     */
+    private deliverInputEvent;
+}

package/esm/src/book-components/Chat/Chat/pagePreview/PagePreviewInputQueue.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/src/book-components/Chat/Chat/pagePreview/PagePreviewSessionState.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Navigation state of one live page-preview browser session, shown in the preview toolbar.
+ *
+ * `canGoBack` / `canGoForward` are `null` when the server cannot inspect the remote history
+ * (for example when the CDP session is unavailable) — the toolbar keeps its buttons enabled then.
+ *
+ * @private type shared between `<LiveBrowserPreview/>` and the Agents Server page-preview routes
+ */
+export type PagePreviewSessionState = {
+    readonly url: string;
+    readonly title: string | null;
+    readonly canGoBack: boolean | null;
+    readonly canGoForward: boolean | null;
+};