@promptbook/editable 0.102.0-1 → 0.102.0-10

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

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

@@ -0,0 +1,39 @@
+/**
+ * Registry of all built-in chat save plugins
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const CHAT_SAVE_FORMATS: readonly [{
+    readonly formatName: "json";
+    readonly label: "JSON (full)";
+    readonly getContent: (messages: import("../types/ChatMessage").ChatMessage[]) => string;
+    readonly mimeType: "application/json";
+    readonly fileExtension: "json";
+}, {
+    readonly formatName: "txt";
+    readonly label: "Plain Text";
+    readonly getContent: (messages: import("../types/ChatMessage").ChatMessage[]) => string;
+    readonly mimeType: "text/plain";
+    readonly fileExtension: "txt";
+}, {
+    readonly formatName: "md";
+    readonly label: "Markdown";
+    readonly getContent: (messages: import("../types/ChatMessage").ChatMessage[]) => string;
+    readonly mimeType: "text/markdown";
+    readonly fileExtension: "md";
+}, {
+    readonly formatName: "html";
+    readonly label: "HTML";
+    readonly getContent: (messages: import("../types/ChatMessage").ChatMessage[]) => string;
+    readonly mimeType: "text/html";
+    readonly fileExtension: "html";
+}, {
+    readonly formatName: "pdf";
+    readonly label: "PDF";
+    readonly getContent: (messages: import("../types/ChatMessage").ChatMessage[]) => string;
+    readonly mimeType: "application/pdf";
+    readonly fileExtension: "pdf";
+}];
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

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

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

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

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

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

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

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

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

@@ -1,16 +1,42 @@
-import type { string_markdown } from '../../../types/typeAliases';
-import type { string_name } from '../../../types/typeAliases';
+import type { id, string_markdown } from '../../../types/typeAliases';
 /**
  * A message in the chat
  *
  * @public exported from `@promptbook/components`
  */
 export type ChatMessage = {
-    id: string;
-    date: Date;
-    from: string_name;
+    /**
+     * Unique identifier of the message
+     */
+    id: id;
+    /**
+     * Date when the message was created
+     */
+    date?: Date;
+    /**
+     * The name of the participant who sent the message
+     */
+    from: id;
+    /**
+     * The content of the message with optional markdown formatting
+     */
     content: string_markdown;
+    /**
+     * Whether the message is complete (for example, if it's still being generated by an AI)
+     *
+     * @default true
+     */
     isComplete?: boolean;
+    /**
+     * @@@
+     */
     expectedAnswer?: string;
+    /**
+     * @@@
+     */
     isVoiceCall?: boolean;
 };
+/**
+ * TODO: Delete `expectedAnswer` from ChatMessage
+ * TODO: Rename `date` into `created`+`modified`
+ */

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

@@ -1,4 +1,4 @@
-import type { string_color, string_name, string_person_fullname, string_url_image } from '../../../types/typeAliases';
+import type { id, string_color, string_person_fullname, string_url_image } from '../../../types/typeAliases';
 import { Color } from '../../../utils/color/Color';
 /**
  * A participant in the chat
@@ -9,11 +9,11 @@ export type ChatParticipant = {
     /**
      * Identifies the participant by their name, same as `message.from`
      */
-    name: string_name;
+    name: id;
     /**
      * Full name of the participant
      */
-    fullname: string_person_fullname;
+    fullname?: string_person_fullname;
     /**
      * Am I the participant? (i.e. is this the user)
      */

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

@@ -7,3 +7,6 @@ import type { ExportFormat } from './ExportFormat';
  * @private utility of `<Chat/>` component
  */
 export declare function exportChatHistory(messages: ChatMessage[], format: ExportFormat, headerMarkdown?: string, participants?: ReadonlyArray<ChatParticipant>): Promise<void>;
+/**
+ * TODO: !!!! Delete this parallel chat history export
+ */

package/esm/typings/src/book-components/icons/AttachmentIcon.d.ts

@@ -0,0 +1,11 @@
+type AttachmentIconProps = {
+    size?: number;
+    color?: string;
+};
+/**
+ * @@@
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function AttachmentIcon({ size, color }: AttachmentIconProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/esm/typings/src/book-components/icons/CloseIcon.d.ts

@@ -0,0 +1,11 @@
+type CloseIconProps = {
+    size?: number;
+    color?: string;
+};
+/**
+ * @@@
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function CloseIcon({ size, color }: CloseIconProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/esm/typings/src/execution/LlmExecutionToolsConstructor.d.ts

@@ -1,4 +1,4 @@
-import type { Registered } from '../utils/$Register';
+import type { Registered } from '../utils/misc/$Register';
 import type { TODO_any } from '../utils/organization/TODO_any';
 import type { LlmExecutionTools } from './LlmExecutionTools';
 /**