@promptbook/pdf 0.113.0-9 → 0.114.0-0

package/esm/src/book-3.0/codexLoginMethod.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Authentication method that the OpenAI Codex CLI used for one run.
+ *
+ * - `chatgpt` — the server's ChatGPT account (subscription) login was used.
+ * - `api` — `OPENAI_API_KEY` API-key authentication was used.
+ * - `unknown` — the runner could not determine which method Codex used.
+ *
+ * @private internal type of the OpenAI Codex runner and the Agents Server task details
+ */
+export type CodexLoginMethod = 'chatgpt' | 'api' | 'unknown';
+/**
+ * Stable stdout marker printed by the generated Codex runner script to report which login method it used.
+ *
+ * The marker is followed by the resolved method keyword, for example `ptbk-codex-login-method: chatgpt`,
+ * so `parseCodexLoginMethodFromOutput` can recover it from the captured runner output.
+ *
+ * @private internal constant of the OpenAI Codex runner
+ */
+export declare const CODEX_LOGIN_METHOD_MARKER = "ptbk-codex-login-method:";
+/**
+ * Substring that the `codex login status` command prints when the Codex CLI is signed in with a
+ * ChatGPT subscription account instead of an `OPENAI_API_KEY`.
+ *
+ * This is the single source of truth for detecting an active ChatGPT login, reused by the Codex runner
+ * script and by the Agents Server harness authentication status resolver.
+ *
+ * @private internal constant of the OpenAI Codex runner and the Agents Server Harness Auth
+ */
+export declare const CODEX_CHATGPT_LOGIN_STATUS_NEEDLE = "Logged in using ChatGPT";
+/**
+ * Formats one Codex login method as a short human-readable label for prompt status lines and task details.
+ *
+ * @returns The label to append to a status line, or `undefined` when there is no meaningful method to show
+ * (for example the runner is not Codex or the method could not be determined), so callers can omit the suffix.
+ *
+ * @private internal utility of the OpenAI Codex runner and the Agents Server task details
+ */
+export declare function formatCodexLoginMethod(loginMethod: CodexLoginMethod | undefined): string | undefined;

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

@@ -0,0 +1,39 @@
+/**
+ * One token emitted while highlighting Book source.
+ *
+ * @private internal type of `BookEditor`
+ */
+export type BookEditorSyntaxTokenName = 'title' | 'commitment' | 'note-commitment' | 'todo-commitment' | 'parameter' | 'agent-reference' | 'code-block';
+/**
+ * Visual style of one Book syntax token.
+ *
+ * @private internal type of `BookEditor`
+ */
+export type BookEditorSyntaxTokenStyle = {
+    /**
+     * Token this style belongs to.
+     */
+    readonly token: BookEditorSyntaxTokenName;
+    /**
+     * Text color of the token.
+     */
+    readonly foreground: string;
+    /**
+     * Optional background color of the token.
+     */
+    readonly background?: string;
+    /**
+     * Optional space-separated font style, for example `bold underline`.
+     */
+    readonly fontStyle?: string;
+};
+/**
+ * Single source of truth for how Book source is colored.
+ *
+ * The Monaco theme of `<BookEditor/>` and every static rendering of Book source
+ * (for example the Book language manual PDF) are derived from these styles, so
+ * a book always looks the same no matter where it is displayed.
+ *
+ * @private internal constant of `BookEditor`
+ */
+export declare const BOOK_EDITOR_SYNTAX_TOKEN_STYLES: ReadonlyArray<BookEditorSyntaxTokenStyle>;

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

@@ -0,0 +1,12 @@
+/**
+ * Creates the CSS matching the markup of `highlightBookSourceToHtml`.
+ *
+ * Both the stylesheet and the markup are derived from the shared
+ * `BOOK_EDITOR_SYNTAX_TOKEN_STYLES`, therefore a statically rendered book keeps
+ * the exact colors of `<BookEditor/>`.
+ *
+ * @returns CSS rules for every Book syntax token.
+ *
+ * @private internal utility of `BookEditor`
+ */
+export declare function createBookSourceHighlightStyles(): string;

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

@@ -0,0 +1,20 @@
+/**
+ * Prefix of the CSS class names emitted for highlighted Book source.
+ *
+ * @private internal constant of `BookEditor`
+ */
+export declare const BOOK_SYNTAX_TOKEN_CLASS_NAME_PREFIX = "book-syntax-";
+/**
+ * Highlights Book source into static HTML using the `<BookEditor/>` token colors.
+ *
+ * `<BookEditor/>` itself is a Monaco-based browser component and cannot run
+ * where a book has to be rendered as plain markup (server-side exports such as
+ * the Book language manual PDF). This function reuses the very same
+ * tokenization patterns and token names, so both surfaces stay in sync.
+ *
+ * @param bookSource - Raw Book source to highlight.
+ * @returns HTML with one `<span>` per highlighted token, safe to place into `<pre>`.
+ *
+ * @private internal utility of `BookEditor`
+ */
+export declare function highlightBookSourceToHtml(bookSource: string): string;

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/ChatMessageItem.d.ts

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

@@ -51,6 +51,10 @@ export type ChatMessageListProps = {
     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
      */
@@ -685,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;
+};

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

@@ -0,0 +1,37 @@
+/**
+ * Viewport of one live page-preview browser session, in CSS pixels.
+ *
+ * @private type shared between `<LiveBrowserPreview/>` and the Agents Server page-preview routes
+ */
+export type PagePreviewViewport = {
+    readonly width: number;
+    readonly height: number;
+};
+/**
+ * Smallest viewport accepted for one live page-preview browser session.
+ *
+ * @private constant shared between `<LiveBrowserPreview/>` and the Agents Server page-preview routes
+ */
+export declare const PAGE_PREVIEW_MIN_VIEWPORT: PagePreviewViewport;
+/**
+ * Largest viewport accepted for one live page-preview browser session.
+ *
+ * @private constant shared between `<LiveBrowserPreview/>` and the Agents Server page-preview routes
+ */
+export declare const PAGE_PREVIEW_MAX_VIEWPORT: PagePreviewViewport;
+/**
+ * Viewport used when the client did not measure its preview area yet.
+ *
+ * @private constant shared between `<LiveBrowserPreview/>` and the Agents Server page-preview routes
+ */
+export declare const PAGE_PREVIEW_DEFAULT_VIEWPORT: PagePreviewViewport;
+/**
+ * Clamps one requested page-preview viewport into the supported bounds.
+ *
+ * @param width - Requested viewport width.
+ * @param height - Requested viewport height.
+ * @returns Rounded viewport within the supported bounds, or `null` when the values are not finite numbers.
+ *
+ * @private utility shared between `<LiveBrowserPreview/>` and the Agents Server page-preview routes
+ */
+export declare function clampPagePreviewViewport(width: unknown, height: unknown): PagePreviewViewport | null;

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

@@ -0,0 +1,20 @@
+/**
+ * Prefix of every live page-preview browser session id.
+ *
+ * @private constant shared between `<LiveBrowserPreview/>` and the Agents Server page-preview routes
+ */
+export declare const PAGE_PREVIEW_SESSION_ID_PREFIX = "page-preview-";
+/**
+ * Pattern accepted for client-created page-preview session identifiers.
+ *
+ * @private constant shared between `<LiveBrowserPreview/>` and the Agents Server page-preview routes
+ */
+export declare const PAGE_PREVIEW_SESSION_ID_PATTERN: RegExp;
+/**
+ * Creates one client-side page-preview browser session id.
+ *
+ * @returns Session id accepted by the Agents Server page-preview routes.
+ *
+ * @private utility of `<LiveBrowserPreview/>`
+ */
+export declare function createPagePreviewSessionId(): string;

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

@@ -0,0 +1,13 @@
+import type { PagePreviewInputEvent } from './PagePreviewInputEvent';
+/**
+ * Validates and normalizes one untrusted page-preview input payload into a typed input event.
+ *
+ * Note: This performs only structural validation shared by client and server — the Agents Server
+ * additionally re-checks `goto` URLs against private/internal targets before navigating.
+ *
+ * @param payload - Unknown JSON payload (usually the parsed request body).
+ * @returns Normalized input event or `null` when the payload is invalid.
+ *
+ * @private utility shared between `<LiveBrowserPreview/>` and the Agents Server page-preview routes
+ */
+export declare function normalizePagePreviewInputEvent(payload: unknown): PagePreviewInputEvent | null;

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

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

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

@@ -0,0 +1,8 @@
+import type { id } from '../../../types/string_token';
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Resolves the stable key used for local chat feedback state.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function resolveChatRatingMessageKey(message: Pick<ChatMessage, 'id' | 'content'>): id;

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

@@ -1,11 +1,13 @@
 /// <reference types="react" />
 import type { string_markdown } from '../../../types/string_markdown';
+import type { MarkdownInlineReference } from '../utils/renderMarkdown';
 /**
  * Props for markdown content.
  */
 type MarkdownContentProps = {
     content: string_markdown;
     className?: string;
+    inlineReferences?: ReadonlyArray<MarkdownInlineReference>;
     onCreateAgent?: (bookContent: string) => void;
     theme?: 'LIGHT' | 'DARK';
 };