@promptbook/documents 0.113.0-8 → 0.113.0-9

package/umd/src/_packages/types.index.d.ts

@@ -20,8 +20,8 @@ import type { AvatarProfileFromSourceProps } from '../book-components/AvatarProf
 import type { BookEditorUploadProgressCallback } from '../book-components/BookEditor/BookEditor';
 import type { BookEditorUploadOptions } from '../book-components/BookEditor/BookEditor';
 import type { BookEditorProps } from '../book-components/BookEditor/BookEditor';
-import type { UploadItem } from '../book-components/BookEditor/useBookEditorMonacoUploads';
-import type { UploadStats } from '../book-components/BookEditor/useBookEditorMonacoUploads';
+import type { UploadItem } from '../book-components/BookEditor/useBookEditorMonacoUploads/bookEditorMonacoUploadTypes';
+import type { UploadStats } from '../book-components/BookEditor/useBookEditorMonacoUploads/bookEditorMonacoUploadTypes';
 import type { AgentChatProps } from '../book-components/Chat/AgentChat/AgentChatProps';
 import type { AgentChipData } from '../book-components/Chat/AgentChip/AgentChip';
 import type { AgentChipProps } from '../book-components/Chat/AgentChip/AgentChip';

package/umd/src/avatars/renderAvatarVisualAsciiArt.d.ts

@@ -1,6 +1,7 @@
 import type { AsciiArtColorDepth } from '../utils/ascii-art/convertImageDataToAsciiArt';
+import type { ResolvedAvatarRenderDefinition } from './renderAvatarVisual';
 import type { AvatarDefinition } from './types/AvatarDefinition';
-import type { AvatarVisualId } from './types/AvatarVisualDefinition';
+import type { AvatarSurfaceStyle, AvatarVisualId } from './types/AvatarVisualDefinition';
 /**
  * Default output width of the ASCII avatar in terminal character cells.
  *
@@ -30,6 +31,12 @@ export type RenderAvatarVisualAsciiArtOptions = {
      * Built-in avatar visual to render, the same one used on the website.
      */
     readonly visualId: AvatarVisualId;
+    /**
+     * Surface used to composite the avatar before ASCII conversion.
+     *
+     * @default 'framed'
+     */
+    readonly surface?: AvatarSurfaceStyle;
     /**
      * Output width in terminal character cells.
      *
@@ -54,6 +61,22 @@ export type RenderAvatarVisualAsciiArtOptions = {
      * @default `STATIC_AVATAR_ASCII_ART_FRAME_TIME_MS`
      */
     readonly timeMs?: number;
+    /**
+     * Source canvas width in CSS pixels before ASCII conversion.
+     *
+     * @default `DEFAULT_AVATAR_SIZE`
+     */
+    readonly canvasWidth?: number;
+    /**
+     * Source canvas height in CSS pixels before ASCII conversion.
+     *
+     * @default `DEFAULT_AVATAR_SIZE`
+     */
+    readonly canvasHeight?: number;
+    /**
+     * Optional stable render data reused across frames.
+     */
+    readonly resolvedAvatarRenderDefinition?: ResolvedAvatarRenderDefinition;
     /**
      * Platform-specific canvas factory used to rasterize the visual.
      */

package/umd/src/avatars/visuals/octopus3dAvatarVisualShared.d.ts

@@ -1,5 +1,5 @@
 import type { AvatarPalette } from '../types/AvatarVisualDefinition';
-import { type Point3D, type ProjectedPoint } from './avatar3dProjectionShared';
+import type { Point3D, ProjectedPoint } from './avatar3dProjectionShared';
 /**
  * Eye-style knobs shared by the proper-3D octopus visuals.
  *

package/umd/src/book-components/BookEditor/BookEditorMonacoUploadPanel.d.ts

@@ -1,4 +1,4 @@
-import type { UploadItem, UploadStats } from './useBookEditorMonacoUploads';
+import type { UploadItem, UploadStats } from './useBookEditorMonacoUploads/bookEditorMonacoUploadTypes';
 /**
  * Props for book editor monaco upload panel.
  */

package/umd/src/book-components/BookEditor/useBookEditorMonacoUploads/bookEditorMonacoUploadTypes.d.ts

@@ -0,0 +1,120 @@
+import type { MutableRefObject } from 'react';
+import type { Promisable } from 'type-fest';
+/**
+ * Type describing upload status.
+ *
+ * @private function of BookEditorMonaco
+ */
+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 progress update.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type UploadProgressUpdate = {
+    readonly progress: number;
+    readonly loadedBytes: number;
+    readonly totalBytes: number;
+};
+/**
+ * Type describing placeholder entry inserted into Monaco while the file uploads.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type UploadPlaceholderEntry = {
+    readonly id: string;
+    readonly file: File;
+    readonly placeholder: 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.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type BookEditorMonacoUploadProgressCallback = (progress: number, stats?: {
+    loadedBytes: number;
+    totalBytes: number;
+}) => void;
+/**
+ * Options for book editor monaco upload.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type BookEditorMonacoUploadOptions = {
+    readonly onProgress?: BookEditorMonacoUploadProgressCallback;
+    readonly abortSignal?: AbortSignal;
+};
+/**
+ * Type describing book editor monaco on file upload.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type BookEditorMonacoOnFileUpload = (file: File, options?: BookEditorMonacoUploadOptions | BookEditorMonacoUploadProgressCallback) => Promisable<string>;
+/**
+ * Setter-like updater used by upload state helpers.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type SetUploadItems = (updater: (items: UploadItem[]) => UploadItem[]) => void;
+/**
+ * Single-upload updater used by upload state helpers.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type UpdateUploadItem = (uploadId: string, createNextUploadItem: (uploadItem: UploadItem) => UploadItem) => void;
+/**
+ * Mutable upload items reference shared across upload helpers.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type UploadItemsRef = MutableRefObject<UploadItem[]>;
+/**
+ * Mutable upload file registry reference shared across upload helpers.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type UploadFilesRef = MutableRefObject<Map<string, File>>;
+/**
+ * Mutable Monaco decoration registry reference shared across upload helpers.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type UploadDecorationIdsRef = MutableRefObject<Map<string, string>>;
+/**
+ * Type describing the callback used to enqueue debounced progress updates.
+ *
+ * @private function of BookEditorMonaco
+ */
+export type QueueProgressUpdate = (uploadId: string, progress: number, loadedBytes: number, totalBytes: number) => void;
+export {};

package/umd/src/book-components/BookEditor/useBookEditorMonacoUploads/clearScheduledTimer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Clears an optional scheduled timer when it exists.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function clearScheduledTimer(timerId: number | null): void;

package/umd/src/book-components/BookEditor/useBookEditorMonacoUploads/enqueueFilesForUpload.d.ts

@@ -0,0 +1,26 @@
+import type { editor } from 'monaco-editor';
+import type { SetUploadItems, UploadPlaceholderEntry } from './bookEditorMonacoUploadTypes';
+/**
+ * Type describing monaco editor.
+ *
+ * @private function of BookEditorMonaco
+ */
+type MonacoEditor = typeof import('monaco-editor');
+/**
+ * Props for Monaco placeholder insertion.
+ *
+ * @private function of BookEditorMonaco
+ */
+type EnqueueFilesForUploadProps = {
+    readonly editor: editor.IStandaloneCodeEditor | null;
+    readonly monaco: MonacoEditor | null;
+    readonly registerUploadPlaceholderResources: (placeholders: ReadonlyArray<UploadPlaceholderEntry>, decorationIds: ReadonlyArray<string>) => void;
+    readonly setUploadItems: SetUploadItems;
+};
+/**
+ * Inserts Monaco placeholders and queues matching upload items.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function enqueueFilesForUpload({ editor, monaco, registerUploadPlaceholderResources, setUploadItems, }: EnqueueFilesForUploadProps): (files: ReadonlyArray<File>) => boolean;
+export {};

package/umd/src/book-components/BookEditor/useBookEditorMonacoUploads/useBookEditorMonacoUploadEditorSync.d.ts

@@ -0,0 +1,23 @@
+import type { editor } from 'monaco-editor';
+import type { UploadDecorationIdsRef, UploadFilesRef, UploadPlaceholderEntry } from './bookEditorMonacoUploadTypes';
+/**
+ * Props for Monaco placeholder and replacement synchronization.
+ *
+ * @private function of BookEditorMonaco
+ */
+type UseBookEditorMonacoUploadEditorSyncProps = {
+    readonly editor: editor.IStandaloneCodeEditor | null;
+    readonly uploadFilesRef: UploadFilesRef;
+    readonly uploadDecorationIdsRef: UploadDecorationIdsRef;
+};
+/**
+ * Manages Monaco placeholder insertion and later replacement with uploaded URLs.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoUploadEditorSync({ editor, uploadFilesRef, uploadDecorationIdsRef, }: UseBookEditorMonacoUploadEditorSyncProps): {
+    registerUploadPlaceholderResources: (placeholders: ReadonlyArray<UploadPlaceholderEntry>, decorationIds: ReadonlyArray<string>) => void;
+    queueEditorReplacement: (uploadId: string, replacementText: string) => void;
+    clearEditorSync: () => void;
+};
+export {};

package/umd/src/book-components/BookEditor/useBookEditorMonacoUploads/useBookEditorMonacoUploadItemsState.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="react" />
+import type { SetUploadItems, UpdateUploadItem, UploadItem, UploadStats } from './bookEditorMonacoUploadTypes';
+/**
+ * Updates one upload item while leaving every other item untouched.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function replaceUploadItemById(uploadItems: ReadonlyArray<UploadItem>, uploadId: string, updateUploadItem: (uploadItem: UploadItem) => UploadItem): Array<UploadItem>;
+/**
+ * Internal upload item state shared by Monaco upload helpers.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoUploadItemsState(): {
+    uploadItems: UploadItem[];
+    uploadItemsRef: import("react").RefObject<UploadItem[]>;
+    setUploadItems: SetUploadItems;
+    updateUploadItem: UpdateUploadItem;
+    uploadStats: UploadStats;
+    activeUploadItems: UploadItem[];
+};

package/umd/src/book-components/BookEditor/useBookEditorMonacoUploads/useBookEditorMonacoUploadProgressQueue.d.ts

@@ -0,0 +1,12 @@
+import type { SetUploadItems } from './bookEditorMonacoUploadTypes';
+/**
+ * Debounces upload progress updates before they hit React state.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoUploadProgressQueue({ setUploadItems, }: {
+    readonly setUploadItems: SetUploadItems;
+}): {
+    queueProgressUpdate: (uploadId: string, progress: number, loadedBytes: number, totalBytes: number) => void;
+    clearProgressQueue: () => void;
+};

package/umd/src/book-components/BookEditor/useBookEditorMonacoUploads/useBookEditorMonacoUploadQueue.d.ts

@@ -0,0 +1,27 @@
+import type { BookEditorMonacoOnFileUpload, QueueProgressUpdate, SetUploadItems, UpdateUploadItem, UploadFilesRef, UploadItemsRef } from './bookEditorMonacoUploadTypes';
+/**
+ * Props for upload queue processing and pause/resume handling.
+ *
+ * @private function of BookEditorMonaco
+ */
+type UseBookEditorMonacoUploadQueueProps = {
+    readonly onFileUpload?: BookEditorMonacoOnFileUpload;
+    readonly uploadItemsRef: UploadItemsRef;
+    readonly uploadFilesRef: UploadFilesRef;
+    readonly queueProgressUpdate: QueueProgressUpdate;
+    readonly queueEditorReplacement: (uploadId: string, replacementText: string) => void;
+    readonly setUploadItems: SetUploadItems;
+    readonly updateUploadItem: UpdateUploadItem;
+};
+/**
+ * Manages upload concurrency, retries, pausing and completion side effects.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoUploadQueue({ onFileUpload, uploadItemsRef, uploadFilesRef, queueProgressUpdate, queueEditorReplacement, setUploadItems, updateUploadItem, }: UseBookEditorMonacoUploadQueueProps): {
+    pauseUpload: (uploadId: string) => void;
+    resumeUpload: (uploadId: string) => void;
+    queueUploadProcessing: () => void;
+    clearUploadQueue: () => void;
+};
+export {};

package/umd/src/book-components/BookEditor/useBookEditorMonacoUploads/useCompletedUploadsAutoClear.d.ts

@@ -0,0 +1,12 @@
+import type { SetUploadItems, UploadDecorationIdsRef, UploadFilesRef, UploadItem } from './bookEditorMonacoUploadTypes';
+/**
+ * Clears upload UI state shortly after all uploads finish.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useCompletedUploadsAutoClear({ uploadItems, uploadFilesRef, uploadDecorationIdsRef, setUploadItems, }: {
+    readonly uploadItems: ReadonlyArray<UploadItem>;
+    readonly uploadFilesRef: UploadFilesRef;
+    readonly uploadDecorationIdsRef: UploadDecorationIdsRef;
+    readonly setUploadItems: SetUploadItems;
+}): void;

package/umd/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/umd/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/umd/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/umd/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/umd/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;

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

@@ -44,6 +44,7 @@ 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;

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

@@ -474,6 +474,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.
      */

package/umd/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/umd/src/book-components/Chat/Chat/useChatInputAreaComposer.draftMessage.test.d.ts

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

package/umd/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/umd/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

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/AGENTS_SERVER_BUILD_CACHE_FILENAME.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Metadata file stored beside the production Next build output.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export declare const AGENTS_SERVER_BUILD_CACHE_FILENAME = ".ptbk-agents-server-build-cache.json";

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/AGENTS_SERVER_BUILD_CACHE_VERSION.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Version of the CLI-owned Agents Server build cache metadata.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export declare const AGENTS_SERVER_BUILD_CACHE_VERSION = 1;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/AGENTS_SERVER_NEXT_BUILD_ID_FILENAME.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Next production build marker required before a cached build is reused.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export declare const AGENTS_SERVER_NEXT_BUILD_ID_FILENAME = "BUILD_ID";

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/AgentsServerBuildCache.d.ts

@@ -0,0 +1,10 @@
+import { AGENTS_SERVER_BUILD_CACHE_VERSION } from './AGENTS_SERVER_BUILD_CACHE_VERSION';
+/**
+ * Metadata persisted after one successful Agents Server production build.
+ *
+ * @private internal type of `buildAgentsServer`
+ */
+export type AgentsServerBuildCache = {
+    readonly version: typeof AGENTS_SERVER_BUILD_CACHE_VERSION;
+    readonly sourceFingerprint: string;
+};

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/AgentsServerBuildCacheOptions.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="node" />
+/**
+ * Input paths required to validate or update the cached Agents Server build.
+ *
+ * @private internal type of `buildAgentsServer`
+ */
+export type AgentsServerBuildCacheOptions = {
+    readonly appPath: string;
+    readonly environment?: NodeJS.ProcessEnv;
+};

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/NODE_MODULES_DIRECTORY_NAME.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Directory segment used for Node package installs.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export declare const NODE_MODULES_DIRECTORY_NAME = "node_modules";