@promptbook/wizard 0.113.0-8 → 0.114.0-0

package/umd/src/book-3.0/AgentMessageRunReport.d.ts

@@ -0,0 +1,78 @@
+import type { Usage } from '../execution/Usage';
+import type { CodexLoginMethod } from './codexLoginMethod';
+/**
+ * File suffix appended to one answered message book to store its run report sidecar.
+ *
+ * For example `messages/finished/2026-07-16-thread.book` is reported in
+ * `messages/finished/2026-07-16-thread.book.report.json`.
+ *
+ * @private internal constant of the agent folder convention
+ */
+export declare const AGENT_MESSAGE_RUN_REPORT_FILE_SUFFIX = ".report.json";
+/**
+ * Report describing how one queued agent message was answered by a CLI harness runner.
+ *
+ * The agent runner writes it next to the answered message book so consumers
+ * (for example the Agents Server task details) can show which runner, authentication
+ * method and usage one answer cost without re-parsing the runner output.
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ *
+ * @private internal type of the agent folder convention
+ */
+export type AgentMessageRunReport = {
+    /**
+     * Report schema version for forward compatibility.
+     */
+    readonly version: 1;
+    /**
+     * Name of the harness runner which answered the message, for example `codex` or `claude-code`.
+     */
+    readonly runnerName: string;
+    /**
+     * Model identifier used by the runner, when known.
+     */
+    readonly modelName?: string;
+    /**
+     * Authentication method the runner used, when it can be determined.
+     *
+     * Currently only the OpenAI Codex runner reports this (its ChatGPT account vs. `OPENAI_API_KEY`);
+     * other runners leave it `undefined`.
+     */
+    readonly loginMethod?: CodexLoginMethod;
+    /**
+     * Usage statistics of the run (price, token counts, duration).
+     */
+    readonly usage: Usage;
+};
+/**
+ * Builds the run-report sidecar path for one message book path.
+ *
+ * Works for absolute and relative paths because the suffix is simply appended.
+ *
+ * @private internal utility of the agent folder convention
+ */
+export declare function buildAgentMessageRunReportPath(messageFilePath: string): string;
+/**
+ * Serializes one run report into the stable JSON format persisted next to the answered message book.
+ *
+ * @private internal utility of the agent folder convention
+ */
+export declare function serializeAgentMessageRunReport(report: AgentMessageRunReport): string;
+/**
+ * Validates one already-parsed JSON value as a run report.
+ *
+ * @returns The typed report, or `null` when the value does not match the expected shape,
+ * so consumers can silently skip malformed or foreign sidecar files.
+ *
+ * @private internal utility of the agent folder convention
+ */
+export declare function normalizeAgentMessageRunReport(value: unknown): AgentMessageRunReport | null;
+/**
+ * Parses one run-report sidecar file content.
+ *
+ * @returns The typed report, or `null` when the content is not valid JSON or does not match the expected shape.
+ *
+ * @private internal utility of the agent folder convention
+ */
+export declare function parseAgentMessageRunReport(reportFileContent: string): AgentMessageRunReport | null;

package/umd/src/book-3.0/AgentMessageRunReport.test.d.ts

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

package/umd/src/book-3.0/agentFolderPaths.d.ts

@@ -28,3 +28,12 @@ export declare const AGENT_FINISHED_MESSAGES_DIRECTORY_PATH: string;
  * @public exported from `@promptbook/node`
  */
 export declare const AGENT_FAILED_MESSAGES_DIRECTORY_PATH: string;
+/**
+ * Relative path to the agent-owned projects root used by the agent folder convention.
+ *
+ * Each direct child directory is one project — an isolated folder the agent fully controls
+ * (files, scripts, optionally its own git repository).
+ *
+ * @private internal constant of the agent folder convention, used by agent runners and the Agents Server
+ */
+export declare const AGENT_PROJECTS_DIRECTORY_PATH = "projects";

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

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

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