@promptbook/cli 0.113.0-8 → 0.114.0-0

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

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

@@ -2,6 +2,17 @@ import { type ChangeEvent, type KeyboardEvent as ReactKeyboardEvent, type Mutabl
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatInputUploadedFile } from './ChatInputUploadedFile';
 import type { ChatProps, ChatSoundSystem } from './ChatProps';
+/**
+ * One programmatic request to replace the composer content with an editable draft.
+ *
+ * A fresh object identity is used for every request so repeated draft insertions
+ * (even with identical text) re-apply to the composer.
+ *
+ * @private function of `<ChatInputArea/>`
+ */
+export type ChatComposerDraft = {
+    readonly content: string;
+};
 /**
  * Props for `useChatInputAreaComposer`.
  *
@@ -11,6 +22,7 @@ type UseChatInputAreaComposerProps = {
     readonly onMessage?: ChatProps['onMessage'];
     readonly onChange?: ChatProps['onChange'];
     readonly defaultMessage?: string;
+    readonly draftMessage?: ChatComposerDraft;
     readonly enterBehavior?: ChatProps['enterBehavior'];
     readonly resolveEnterBehavior?: ChatProps['resolveEnterBehavior'];
     readonly isFocusedOnLoad?: boolean;

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

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

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

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

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

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

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

package/esm/src/book-components/Chat/utils/isVisibleChatToolCall.d.ts

@@ -1,4 +1,4 @@
-import { type ToolCall } from '../../../types/ToolCall';
+import type { ToolCall } from '../../../types/ToolCall';
 /**
  * Returns true when one tool call represents a user-facing action.
  *

package/esm/src/book-components/Chat/utils/parseMessageButtons.d.ts

@@ -8,6 +8,19 @@ export type MessageQuickButton = {
     text: string;
     message: string;
 };
+/**
+ * Represents a quick draft-message button parsed from chat markdown.
+ *
+ * Unlike `MessageQuickButton`, clicking this button prefills the composer with an
+ * editable draft instead of sending the message immediately.
+ *
+ * @private internal helper type of `MessageButton`
+ */
+export type MessageDraftQuickButton = {
+    type: 'messageDraft';
+    text: string;
+    messageDraft: string;
+};
 /**
  * Represents a quick action button parsed from chat markdown.
  *
@@ -23,9 +36,10 @@ export type ActionQuickButton = {
  *
  * @public exported from `@promptbook/components`
  */
-export type MessageButton = MessageQuickButton | ActionQuickButton;
+export type MessageButton = MessageQuickButton | MessageDraftQuickButton | ActionQuickButton;
 /**
- * Parses markdown quick buttons in the format `[Button Text](?message=...)` or `[Button Text](?action=...)`.
+ * Parses markdown quick buttons in the format `[Button Text](?message=...)`, `[Button Text](?messageDraft=...)`
+ * or `[Button Text](?action=...)`.
  * Returns both the content without supported quick buttons and the extracted button definitions.
  *
  * @param content The markdown content that may contain buttons