@promptbook/node 0.102.0-1 → 0.102.0-11

package/esm/typings/books/index.d.ts

@@ -127,5 +127,86 @@ declare const _default: ({
         content: string;
     }[];
     sourceFile: string;
+} | {
+    title: string;
+    pipelineUrl: string;
+    formfactorName: string;
+    parameters: {
+        name: string;
+        isInput: boolean;
+        isOutput: boolean;
+    }[];
+    tasks: {
+        taskType: string;
+        name: string;
+        title: string;
+        content: string;
+        resultingParameterName: string;
+        dependentParameterNames: never[];
+    }[];
+    personas: never[];
+    preparations: {
+        id: number;
+        promptbookVersion: string;
+        usage: {
+            price: {
+                value: number;
+            };
+            input: {
+                tokensCount: {
+                    value: number;
+                };
+                charactersCount: {
+                    value: number;
+                };
+                wordsCount: {
+                    value: number;
+                };
+                sentencesCount: {
+                    value: number;
+                };
+                linesCount: {
+                    value: number;
+                };
+                paragraphsCount: {
+                    value: number;
+                };
+                pagesCount: {
+                    value: number;
+                };
+            };
+            output: {
+                tokensCount: {
+                    value: number;
+                };
+                charactersCount: {
+                    value: number;
+                };
+                wordsCount: {
+                    value: number;
+                };
+                sentencesCount: {
+                    value: number;
+                };
+                linesCount: {
+                    value: number;
+                };
+                paragraphsCount: {
+                    value: number;
+                };
+                pagesCount: {
+                    value: number;
+                };
+            };
+        };
+    }[];
+    knowledgeSources: never[];
+    knowledgePieces: never[];
+    sources: {
+        type: string;
+        path: null;
+        content: string;
+    }[];
+    sourceFile: string;
 })[];
 export default _default;

package/esm/typings/src/_packages/components.index.d.ts

@@ -26,14 +26,15 @@ import { MOCKED_CHAT_DELAY_CONFIGS } from '../book-components/Chat/MockedChat/co
 import type { MockedChatDelayConfig } from '../book-components/Chat/MockedChat/MockedChat';
 import type { MockedChatProps } from '../book-components/Chat/MockedChat/MockedChat';
 import { MockedChat } from '../book-components/Chat/MockedChat/MockedChat';
-import type { string_chat_format_name } from '../book-components/Chat/save/savePlugins';
-import type { ChatSaveFormatDefinition } from '../book-components/Chat/save/savePlugins';
-import { jsonSaveFormatDefinition } from '../book-components/Chat/save/savePlugins';
-import { txtSaveFormatDefinition } from '../book-components/Chat/save/savePlugins';
-import { mdSaveFormatDefinition } from '../book-components/Chat/save/savePlugins';
-import { htmlSaveFormatDefinition } from '../book-components/Chat/save/savePlugins';
-import { CHAT_SAVE_FORMATS } from '../book-components/Chat/save/savePlugins';
-import { getChatSaveFormatDefinitions } from '../book-components/Chat/save/savePlugins';
+import type { ChatSaveFormatDefinition } from '../book-components/Chat/save/_common/ChatSaveFormatDefinition';
+import { getChatSaveFormatDefinitions } from '../book-components/Chat/save/_common/getChatSaveFormatDefinitions';
+import type { string_chat_format_name } from '../book-components/Chat/save/_common/string_chat_format_name';
+import { htmlSaveFormatDefinition } from '../book-components/Chat/save/html/htmlSaveFormatDefinition';
+import { CHAT_SAVE_FORMATS } from '../book-components/Chat/save/index';
+import { jsonSaveFormatDefinition } from '../book-components/Chat/save/json/jsonSaveFormatDefinition';
+import { mdSaveFormatDefinition } from '../book-components/Chat/save/markdown/mdSaveFormatDefinition';
+import { pdfSaveFormatDefinition } from '../book-components/Chat/save/pdf/pdfSaveFormatDefinition';
+import { txtSaveFormatDefinition } from '../book-components/Chat/save/text/txtSaveFormatDefinition';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
 import type { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
@@ -41,11 +42,14 @@ import { parseMessageButtons } from '../book-components/Chat/utils/parseMessageB
 import { renderMarkdown } from '../book-components/Chat/utils/renderMarkdown';
 import { isMarkdownContent } from '../book-components/Chat/utils/renderMarkdown';
 import { ArrowIcon } from '../book-components/icons/ArrowIcon';
+import { AttachmentIcon } from '../book-components/icons/AttachmentIcon';
+import { CloseIcon } from '../book-components/icons/CloseIcon';
 import { PauseIcon } from '../book-components/icons/PauseIcon';
 import { PlayIcon } from '../book-components/icons/PlayIcon';
 import { ResetIcon } from '../book-components/icons/ResetIcon';
 import { SendIcon } from '../book-components/icons/SendIcon';
 import { TemplateIcon } from '../book-components/icons/TemplateIcon';
+import { injectCssModuleIntoShadowRoot } from '../utils/misc/injectCssModuleIntoShadowRoot';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export type { AvatarChipProps };
 export { AvatarChip };
@@ -74,14 +78,15 @@ export { MOCKED_CHAT_DELAY_CONFIGS };
 export type { MockedChatDelayConfig };
 export type { MockedChatProps };
 export { MockedChat };
-export type { string_chat_format_name };
 export type { ChatSaveFormatDefinition };
-export { jsonSaveFormatDefinition };
-export { txtSaveFormatDefinition };
-export { mdSaveFormatDefinition };
+export { getChatSaveFormatDefinitions };
+export type { string_chat_format_name };
 export { htmlSaveFormatDefinition };
 export { CHAT_SAVE_FORMATS };
-export { getChatSaveFormatDefinitions };
+export { jsonSaveFormatDefinition };
+export { mdSaveFormatDefinition };
+export { pdfSaveFormatDefinition };
+export { txtSaveFormatDefinition };
 export type { ChatMessage };
 export type { ChatParticipant };
 export type { MessageButton };
@@ -89,8 +94,11 @@ export { parseMessageButtons };
 export { renderMarkdown };
 export { isMarkdownContent };
 export { ArrowIcon };
+export { AttachmentIcon };
+export { CloseIcon };
 export { PauseIcon };
 export { PlayIcon };
 export { ResetIcon };
 export { SendIcon };
 export { TemplateIcon };
+export { injectCssModuleIntoShadowRoot };

package/esm/typings/src/_packages/markdown-utils.index.d.ts

@@ -29,6 +29,8 @@ import { removeMarkdownComments } from '../utils/markdown/removeMarkdownComments
 import { removeMarkdownFormatting } from '../utils/markdown/removeMarkdownFormatting';
 import { removeMarkdownLinks } from '../utils/markdown/removeMarkdownLinks';
 import { splitMarkdownIntoSections } from '../utils/markdown/splitMarkdownIntoSections';
+import { trimCodeBlock } from '../utils/markdown/trimCodeBlock';
+import { trimEndOfCodeBlock } from '../utils/markdown/trimEndOfCodeBlock';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { extractBlock };
 export { extractJsonBlock };
@@ -60,3 +62,5 @@ export { removeMarkdownComments };
 export { removeMarkdownFormatting };
 export { removeMarkdownLinks };
 export { splitMarkdownIntoSections };
+export { trimCodeBlock };
+export { trimEndOfCodeBlock };

package/esm/typings/src/_packages/types.index.d.ts

@@ -16,8 +16,8 @@ import type { SendMessageToLlmChatFunction } from '../book-components/Chat/hooks
 import type { LlmChatProps } from '../book-components/Chat/LlmChat/LlmChatProps';
 import type { MockedChatDelayConfig } from '../book-components/Chat/MockedChat/MockedChat';
 import type { MockedChatProps } from '../book-components/Chat/MockedChat/MockedChat';
-import type { string_chat_format_name } from '../book-components/Chat/save/savePlugins';
-import type { ChatSaveFormatDefinition } from '../book-components/Chat/save/savePlugins';
+import type { ChatSaveFormatDefinition } from '../book-components/Chat/save/_common/ChatSaveFormatDefinition';
+import type { string_chat_format_name } from '../book-components/Chat/save/_common/string_chat_format_name';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
 import type { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
@@ -154,6 +154,7 @@ import type { ApplicationRemoteServerOptions } from '../remote-server/types/Remo
 import type { ApplicationRemoteServerClientOptions } from '../remote-server/types/RemoteServerOptions';
 import type { LoginRequest } from '../remote-server/types/RemoteServerOptions';
 import type { LoginResponse } from '../remote-server/types/RemoteServerOptions';
+import type { ServerInfo } from '../remote-server/ui/types';
 import type { Converter } from '../scrapers/_common/Converter';
 import type { ScraperAndConverterMetadata } from '../scrapers/_common/register/ScraperAndConverterMetadata';
 import type { ScraperConstructor } from '../scrapers/_common/register/ScraperConstructor';
@@ -305,15 +306,16 @@ import type { number_kilobytes } from '../types/typeAliases';
 import type { number_megabytes } from '../types/typeAliases';
 import type { number_gigabytes } from '../types/typeAliases';
 import type { number_terabytes } from '../types/typeAliases';
-import type { Registered } from '../utils/$Register';
-import type { Registration } from '../utils/$Register';
 import type { ColorTransformer } from '../utils/color/operators/ColorTransformer';
 import type { PipelineEditableSerialized } from '../utils/editable/types/PipelineEditableSerialized';
 import type { ExecCommandOptions } from '../utils/execCommand/ExecCommandOptions';
 import type { ExecCommandOptionsAdvanced } from '../utils/execCommand/ExecCommandOptions';
-import type { FromtoItems } from '../utils/FromtoItems';
 import type { CodeBlock } from '../utils/markdown/extractAllBlocksFromMarkdown';
 import type { MarkdownSection } from '../utils/markdown/parseMarkdownSection';
+import type { Registered } from '../utils/misc/$Register';
+import type { Registration } from '../utils/misc/$Register';
+import type { FromtoItems } from '../utils/misc/FromtoItems';
+import type { InjectCssModuleIntoShadowRootOptions } from '../utils/misc/injectCssModuleIntoShadowRoot';
 import type { string_keyword } from '../utils/normalization/IKeywords';
 import type { Keywords } from '../utils/normalization/IKeywords';
 import type { string_kebab_case } from '../utils/normalization/normalize-to-kebab-case';
@@ -347,8 +349,8 @@ export type { SendMessageToLlmChatFunction };
 export type { LlmChatProps };
 export type { MockedChatDelayConfig };
 export type { MockedChatProps };
-export type { string_chat_format_name };
 export type { ChatSaveFormatDefinition };
+export type { string_chat_format_name };
 export type { ChatMessage };
 export type { ChatParticipant };
 export type { MessageButton };
@@ -485,6 +487,7 @@ export type { ApplicationRemoteServerOptions };
 export type { ApplicationRemoteServerClientOptions };
 export type { LoginRequest };
 export type { LoginResponse };
+export type { ServerInfo };
 export type { Converter };
 export type { ScraperAndConverterMetadata };
 export type { ScraperConstructor };
@@ -636,15 +639,16 @@ export type { number_kilobytes };
 export type { number_megabytes };
 export type { number_gigabytes };
 export type { number_terabytes };
-export type { Registered };
-export type { Registration };
 export type { ColorTransformer };
 export type { PipelineEditableSerialized };
 export type { ExecCommandOptions };
 export type { ExecCommandOptionsAdvanced };
-export type { FromtoItems };
 export type { CodeBlock };
 export type { MarkdownSection };
+export type { Registered };
+export type { Registration };
+export type { FromtoItems };
+export type { InjectCssModuleIntoShadowRootOptions };
 export type { string_keyword };
 export type { Keywords };
 export type { string_kebab_case };

package/esm/typings/src/_packages/utils.index.d.ts

@@ -11,7 +11,6 @@ import { jsonParse } from '../formats/json/utils/jsonParse';
 import { isValidXmlString } from '../formats/xml/utils/isValidXmlString';
 import { prompt } from '../pipeline/prompt-notation';
 import { promptTemplate } from '../pipeline/prompt-notation';
-import { $getCurrentDate } from '../utils/$getCurrentDate';
 import { $isRunningInBrowser } from '../utils/environment/$isRunningInBrowser';
 import { $isRunningInJest } from '../utils/environment/$isRunningInJest';
 import { $isRunningInNode } from '../utils/environment/$isRunningInNode';
@@ -26,6 +25,9 @@ import { splitIntoSentences } from '../utils/expectation-counters/countSentences
 import { countSentences } from '../utils/expectation-counters/countSentences';
 import { countWords } from '../utils/expectation-counters/countWords';
 import { CountUtils } from '../utils/expectation-counters/index';
+import { $getCurrentDate } from '../utils/misc/$getCurrentDate';
+import { debounce } from '../utils/misc/debounce';
+import { parseNumber } from '../utils/misc/parseNumber';
 import { capitalize } from '../utils/normalization/capitalize';
 import { decapitalize } from '../utils/normalization/decapitalize';
 import { DIACRITIC_VARIANTS_LETTERS } from '../utils/normalization/DIACRITIC_VARIANTS_LETTERS';
@@ -48,17 +50,17 @@ import { orderJson } from '../utils/normalization/orderJson';
 import { parseKeywords } from '../utils/normalization/parseKeywords';
 import { parseKeywordsFromString } from '../utils/normalization/parseKeywordsFromString';
 import { removeDiacritics } from '../utils/normalization/removeDiacritics';
+import { removeEmojis } from '../utils/normalization/removeEmojis';
+import { removeQuotes } from '../utils/normalization/removeQuotes';
 import { searchKeywords } from '../utils/normalization/searchKeywords';
 import { suffixUrl } from '../utils/normalization/suffixUrl';
 import { titleToName } from '../utils/normalization/titleToName';
+import { unwrapResult } from '../utils/normalization/unwrapResult';
 import { spaceTrim } from '../utils/organization/spaceTrim';
 import { extractParameterNames } from '../utils/parameters/extractParameterNames';
 import { numberToString } from '../utils/parameters/numberToString';
 import { templateParameters } from '../utils/parameters/templateParameters';
 import { valueToString } from '../utils/parameters/valueToString';
-import { parseNumber } from '../utils/parseNumber';
-import { removeEmojis } from '../utils/removeEmojis';
-import { removeQuotes } from '../utils/removeQuotes';
 import { $deepFreeze } from '../utils/serialization/$deepFreeze';
 import { checkSerializableAsJson } from '../utils/serialization/checkSerializableAsJson';
 import { clonePipeline } from '../utils/serialization/clonePipeline';
@@ -69,9 +71,6 @@ import { jsonStringsToJsons } from '../utils/serialization/jsonStringsToJsons';
 import { difference } from '../utils/sets/difference';
 import { intersection } from '../utils/sets/intersection';
 import { union } from '../utils/sets/union';
-import { trimCodeBlock } from '../utils/trimCodeBlock';
-import { trimEndOfCodeBlock } from '../utils/trimEndOfCodeBlock';
-import { unwrapResult } from '../utils/unwrapResult';
 import { isValidEmail } from '../utils/validators/email/isValidEmail';
 import { isRootPath } from '../utils/validators/filePath/isRootPath';
 import { isValidFilePath } from '../utils/validators/filePath/isValidFilePath';
@@ -96,7 +95,6 @@ export { jsonParse };
 export { isValidXmlString };
 export { prompt };
 export { promptTemplate };
-export { $getCurrentDate };
 export { $isRunningInBrowser };
 export { $isRunningInJest };
 export { $isRunningInNode };
@@ -111,6 +109,9 @@ export { splitIntoSentences };
 export { countSentences };
 export { countWords };
 export { CountUtils };
+export { $getCurrentDate };
+export { debounce };
+export { parseNumber };
 export { capitalize };
 export { decapitalize };
 export { DIACRITIC_VARIANTS_LETTERS };
@@ -133,17 +134,17 @@ export { orderJson };
 export { parseKeywords };
 export { parseKeywordsFromString };
 export { removeDiacritics };
+export { removeEmojis };
+export { removeQuotes };
 export { searchKeywords };
 export { suffixUrl };
 export { titleToName };
+export { unwrapResult };
 export { spaceTrim };
 export { extractParameterNames };
 export { numberToString };
 export { templateParameters };
 export { valueToString };
-export { parseNumber };
-export { removeEmojis };
-export { removeQuotes };
 export { $deepFreeze };
 export { checkSerializableAsJson };
 export { clonePipeline };
@@ -154,9 +155,6 @@ export { jsonStringsToJsons };
 export { difference };
 export { intersection };
 export { union };
-export { trimCodeBlock };
-export { trimEndOfCodeBlock };
-export { unwrapResult };
 export { isValidEmail };
 export { isRootPath };
 export { isValidFilePath };

package/esm/typings/src/book-2.0/agent-source/createAgentModelRequirements.d.ts

@@ -1,5 +1,5 @@
 import type { AvailableModel } from '../../execution/AvailableModel';
-import { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { string_model_name } from '../../types/typeAliases';
 import type { AgentModelRequirements } from './AgentModelRequirements';
 import type { string_book } from './string_book';

package/esm/typings/src/book-2.0/utils/generateGravatarUrl.d.ts

@@ -1,4 +1,4 @@
-import { string_agent_name } from '../../types/typeAliases';
+import type { string_agent_name } from '../../types/typeAliases';
 /**
  * Generates a gravatar URL based on agent name for fallback avatar
  *

package/esm/typings/src/book-2.0/utils/generatePlaceholderAgentProfileImageUrl.d.ts

@@ -1,4 +1,4 @@
-import { string_agent_name, string_url_image } from '../../types/typeAliases';
+import type { string_agent_name, string_url_image } from '../../types/typeAliases';
 /**
  * Generates an image for the agent to use as profile image
  *

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

@@ -1,7 +1,7 @@
 import type { CSSProperties } from 'react';
 import type { Promisable } from 'type-fest';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
-import { string_knowledge_source_content } from '../../types/typeAliases';
+import type { string_knowledge_source_content } from '../../types/typeAliases';
 /**
  * Props of `BookEditor`
  *

package/esm/typings/src/book-components/BookEditor/BookEditorInner.d.ts

@@ -1,4 +1,4 @@
-import { BookEditorProps } from './BookEditor';
+import type { BookEditorProps } from './BookEditor';
 /**
  * @private util of `<BookEditor />`
  */

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

@@ -1,4 +1,3 @@
-import { string_chat_format_name } from '../save/savePlugins';
 import type { ChatProps } from './ChatProps';
 /**
  * Renders a chat with messages and input for new messages
@@ -13,7 +12,4 @@ import type { ChatProps } from './ChatProps';
  *
  * @public exported from `@promptbook/components`
  */
-export declare function Chat(props: ChatProps & {
-    saveFormats?: string_chat_format_name[];
-    isSaveButtonEnabled?: boolean;
-}): import("react/jsx-runtime").JSX.Element;
+export declare function Chat(props: ChatProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,35 @@
+/// <reference types="react" />
+import type { id } from '../../../types/typeAliases';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatParticipant } from '../types/ChatParticipant';
+import type { ChatProps } from './ChatProps';
+/**
+ * Props for the `ChatMessageItem` component
+ *
+ * @private props for internal subcomponent
+ */
+type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'participants'> & {
+    message: ChatMessage;
+    participant: ChatParticipant | undefined;
+    isLastMessage: boolean;
+    setExpandedMessageId: (value: id | null) => void;
+    isExpanded: boolean;
+    currentRating: number;
+    handleRating: (message: ChatMessage, rating: number) => void;
+    mode: 'LIGHT' | 'DARK';
+    /**
+     * Enables the copy button for this message bubble.
+     */
+    isCopyButtonEnabled?: boolean;
+    /**
+     * Enables the feedback (rating) UI for this message bubble.
+     */
+    isFeedbackEnabled?: boolean;
+};
+/**
+ * Renders a single chat message item with avatar, content, buttons, and rating.
+ *
+ * @private internal subcomponent of `<Chat>` component
+ */
+export declare const ChatMessageItem: import("react").MemoExoticComponent<({ message, participant, participants, isLastMessage, onMessage, setExpandedMessageId, isExpanded, currentRating, handleRating, mode, isCopyButtonEnabled, isFeedbackEnabled, }: ChatMessageItemProps) => import("react/jsx-runtime").JSX.Element>;
+export {};

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

@@ -1,5 +1,6 @@
 import type { CSSProperties, ReactNode } from 'react';
 import type { Promisable } from 'type-fest';
+import type { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
 /**
@@ -91,12 +92,6 @@ export type ChatProps = {
         onAssistantVoiceResponse?: (content: string, isVoiceCall: boolean) => void;
         onVoiceCallStateChange?: (isVoiceCalling: boolean) => void;
     };
-    /**
-     * Indicates whether a the text is AI-generated and should be humanized
-     *
-     * @default true
-     */
-    readonly isAiTextHumanized?: boolean;
     /**
      * Indicates whether a voice call is currently active
      */
@@ -109,12 +104,24 @@ export type ChatProps = {
      * Whether the save button is enabled and shown
      */
     readonly isSaveButtonEnabled?: boolean;
+    /**
+     * List of formats in which the chat can be saved/exported
+     *
+     * @default * All supported formats (see `string_chat_format_name` type)
+     */
+    readonly saveFormats?: Array<string_chat_format_name>;
     /**
      * Is the writing textarea automatically focused?
      *
      * @default true on Desktop false on mobile (to prevent mobile keyboard from popping up)
      */
     readonly isFocusedOnLoad?: boolean;
+    /**
+     * Indicates whether the text shown in chat should be post-processed by removing AI artifacts and making it more "human-like" and "promptbook-like"
+     *
+     * @default true
+     */
+    readonly isAiTextHumanizedAndPromptbookified?: boolean;
     /**
      * Optional markdown header to include at the top of exported files.
      * Example: "## Discussion Topic\n\nSome topic here"
@@ -145,7 +152,22 @@ export type ChatProps = {
         expectedAnswer: string | null;
         url: string;
     }): Promisable<void>;
+    /**
+     * Optional callback for handling file uploads
+     * When provided, enables file upload functionality via drag-and-drop and file button
+     * The callback should process the file and return text content to be inserted into the message
+     *
+     * @param file - The uploaded file
+     * @returns Promise or string with the text content to insert into the chat message
+     */
+    onFileUpload?(file: File): Promisable<string>;
+    /**
+     * Enables the copy button for each message bubble.
+     * When true, a copy button appears in the top-right of each message.
+     * @default true
+     */
+    isCopyButtonEnabled?: boolean;
 };
 /**
  * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
- */ 
+ */

package/esm/typings/src/book-components/Chat/Chat/constants.d.ts

@@ -3,6 +3,13 @@
  * @private util of `<Chat />`
  */
 export declare const LOADING_INTERACTIVE_IMAGE = "Loading...";
+/**
+ * [🚉] Avatar dimensions constant to prevent layout jumps and maintain DRY principle
+ *
+ * @deprecated use `isComplete` instead
+ * @private util of `<Chat />`
+ */
+export declare const AVATAR_SIZE = 40;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-components/Chat/LlmChat/LlmChatProps.d.ts

@@ -1,14 +1,20 @@
 import type { LlmExecutionTools } from '../../../execution/LlmExecutionTools';
+import type { id } from '../../../types/typeAliases';
 import type { ChatProps } from '../Chat/ChatProps';
+import type { SendMessageToLlmChatFunction } from '../hooks/useSendMessageToLlmChat';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
-import type { SendMessageToLlmChatFunction } from '../hooks/useSendMessageToLlmChat';
 /**
  * Props for LlmChat component, derived from ChatProps but with LLM-specific modifications
  *
  * @public exported from `@promptbook/components`
  */
 export type LlmChatProps = Omit<ChatProps, 'messages' | 'onMessage' | 'onChange'> & {
+    /**
+     * Optional thread (full chat history) to be passed to LLM execution tools.
+     * If not provided, the internal messages state will be used.
+     */
+    readonly thread?: ReadonlyArray<ChatMessage>;
     /**
      * LLM execution tools for chatting with the model
      */
@@ -34,4 +40,16 @@ export type LlmChatProps = Omit<ChatProps, 'messages' | 'onMessage' | 'onChange'
      * When provided, LlmChat will attach its internal handler to it (no React context needed).
      */
     readonly sendMessage?: SendMessageToLlmChatFunction;
+    /**
+     * Name of the USER as participant in the chat
+     *
+     * @default 'USER'
+     */
+    readonly userParticipantName?: id;
+    /**
+     * Name of the LLM as participant in the chat
+     *
+     * @default 'ASSISTANT'
+     */
+    readonly llmParticipantName?: id;
 };

package/esm/typings/src/book-components/Chat/MockedChat/MockedChat.d.ts

@@ -1,4 +1,4 @@
-import type { ChatProps } from '../../Chat/Chat/ChatProps';
+import type { ChatProps } from '../Chat/ChatProps';
 /**
  * Delay configuration for the MockedChat component
  *

package/esm/typings/src/book-components/Chat/MockedChat/constants.d.ts

@@ -1,4 +1,4 @@
-import { MockedChatDelayConfig } from './MockedChat';
+import type { MockedChatDelayConfig } from './MockedChat';
 /**
  * Normal flow of messages in the `MockedChat` component
  *

package/esm/typings/src/book-components/Chat/save/_common/ChatSaveFormatDefinition.d.ts

@@ -0,0 +1,13 @@
+import type { string_file_extension, string_mime_type } from '../../../../types/typeAliases';
+import type { ChatMessage } from '../../types/ChatMessage';
+/**
+ * Plugin contract for chat export formatNames
+ * @public exported from `@promptbook/components`
+ */
+export type ChatSaveFormatDefinition = {
+    formatName: string_file_extension | string_mime_type | string;
+    label: string;
+    getContent: (messages: ChatMessage[]) => string;
+    mimeType: string;
+    fileExtension: string;
+};

package/esm/typings/src/book-components/Chat/save/_common/getChatSaveFormatDefinitions.d.ts

@@ -0,0 +1,8 @@
+import type { ChatSaveFormatDefinition } from './ChatSaveFormatDefinition';
+import type { string_chat_format_name } from './string_chat_format_name';
+/**
+ * Returns enabled chat save plugins filtered by formatNames (or all when omitted)
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function getChatSaveFormatDefinitions(formatNames?: ReadonlyArray<string_chat_format_name>): ReadonlyArray<ChatSaveFormatDefinition>;

package/esm/typings/src/book-components/Chat/save/_common/string_chat_format_name.d.ts

@@ -0,0 +1,6 @@
+import { CHAT_SAVE_FORMATS } from '../index';
+/**
+ * Supported chat export formatNames
+ * @public exported from `@promptbook/components`
+ */
+export type string_chat_format_name = typeof CHAT_SAVE_FORMATS[number]['formatName'];

package/esm/typings/src/book-components/Chat/save/html/htmlSaveFormatDefinition.d.ts

@@ -0,0 +1,12 @@
+/**
+ * HTML export plugin
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const htmlSaveFormatDefinition: {
+    readonly formatName: "html";
+    readonly label: "HTML";
+    readonly getContent: (messages: import("../../types/ChatMessage").ChatMessage[]) => string;
+    readonly mimeType: "text/html";
+    readonly fileExtension: "html";
+};