@promptbook/javascript 0.110.0-9 → 0.111.0-0

package/esm/index.es.js

@@ -18,7 +18,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.110.0-9';
+const PROMPTBOOK_ENGINE_VERSION = '0.111.0-0';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

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

@@ -15,10 +15,12 @@ import { BookEditor } from '../book-components/BookEditor/BookEditor';
 import { AgentChat } from '../book-components/Chat/AgentChat/AgentChat';
 import type { AgentChatProps } from '../book-components/Chat/AgentChat/AgentChatProps';
 import { Chat } from '../book-components/Chat/Chat/Chat';
+import type { ChatFeedbackResponse } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatSoundSystem } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatProps } from '../book-components/Chat/Chat/ChatProps';
 import { ChatSoundToggle } from '../book-components/Chat/Chat/ChatSoundToggle';
 import { ChatVibrationToggle } from '../book-components/Chat/Chat/ChatSoundToggle';
+import { ChatSoundAndVibrationPanel } from '../book-components/Chat/Chat/ChatSoundToggle';
 import { ChatEffectsSystem } from '../book-components/Chat/effects/ChatEffectsSystem';
 import { ConfettiEffect } from '../book-components/Chat/effects/components/ConfettiEffect';
 import { HeartsEffect } from '../book-components/Chat/effects/components/HeartsEffect';
@@ -86,10 +88,12 @@ export { BookEditor };
 export { AgentChat };
 export type { AgentChatProps };
 export { Chat };
+export type { ChatFeedbackResponse };
 export type { ChatSoundSystem };
 export type { ChatProps };
 export { ChatSoundToggle };
 export { ChatVibrationToggle };
+export { ChatSoundAndVibrationPanel };
 export { ChatEffectsSystem };
 export { ConfettiEffect };
 export { HeartsEffect };

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

@@ -1,7 +1,7 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
 import { computeAgentHash } from '../book-2.0/agent-source/computeAgentHash';
 import { createAgentModelRequirements } from '../book-2.0/agent-source/createAgentModelRequirements';
-import { createAgentModelRequirementsWithCommitments } from '../book-2.0/agent-source/createAgentModelRequirementsWithCommitments';
+import type { CreateAgentModelRequirementsOptions } from '../book-2.0/agent-source/CreateAgentModelRequirementsOptions';
 import { createDefaultAgentName } from '../book-2.0/agent-source/createDefaultAgentName';
 import { normalizeAgentName } from '../book-2.0/agent-source/normalizeAgentName';
 import { PADDING_LINES } from '../book-2.0/agent-source/padBook';
@@ -205,7 +205,7 @@ import { PUBLIC_AGENTS_SERVERS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { computeAgentHash };
 export { createAgentModelRequirements };
-export { createAgentModelRequirementsWithCommitments };
+export type { CreateAgentModelRequirementsOptions };
 export { createDefaultAgentName };
 export { normalizeAgentName };
 export { PADDING_LINES };

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

@@ -2,6 +2,7 @@ import type { BookParameter } from '../book-2.0/agent-source/AgentBasicInformati
 import type { AgentCapability } from '../book-2.0/agent-source/AgentBasicInformation';
 import type { AgentBasicInformation } from '../book-2.0/agent-source/AgentBasicInformation';
 import type { AgentModelRequirements } from '../book-2.0/agent-source/AgentModelRequirements';
+import type { CreateAgentModelRequirementsOptions } from '../book-2.0/agent-source/CreateAgentModelRequirementsOptions';
 import type { string_book } from '../book-2.0/agent-source/string_book';
 import type { AvatarChipProps } from '../book-components/AvatarProfile/AvatarChip/AvatarChip';
 import type { AvatarChipFromSourceProps } from '../book-components/AvatarProfile/AvatarChip/AvatarChipFromSource';
@@ -13,10 +14,12 @@ import type { BookEditorProps } from '../book-components/BookEditor/BookEditor';
 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';
+import type { ChatFeedbackResponse } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatSoundSystem } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatProps } from '../book-components/Chat/Chat/ChatProps';
 import type { ChatSoundToggleProps } from '../book-components/Chat/Chat/ChatSoundToggle';
 import type { ChatVibrationToggleProps } from '../book-components/Chat/Chat/ChatSoundToggle';
+import type { ChatSoundAndVibrationPanelProps } from '../book-components/Chat/Chat/ChatSoundToggle';
 import type { ChatEffect } from '../book-components/Chat/effects/types/ChatEffect';
 import type { ChatEffectConfig } from '../book-components/Chat/effects/types/ChatEffectConfig';
 import type { ChatEffectsSystemProps } from '../book-components/Chat/effects/types/ChatEffectsSystemProps';
@@ -407,6 +410,7 @@ export type { BookParameter };
 export type { AgentCapability };
 export type { AgentBasicInformation };
 export type { AgentModelRequirements };
+export type { CreateAgentModelRequirementsOptions };
 export type { string_book };
 export type { AvatarChipProps };
 export type { AvatarChipFromSourceProps };
@@ -418,10 +422,12 @@ export type { BookEditorProps };
 export type { AgentChatProps };
 export type { AgentChipData };
 export type { AgentChipProps };
+export type { ChatFeedbackResponse };
 export type { ChatSoundSystem };
 export type { ChatProps };
 export type { ChatSoundToggleProps };
 export type { ChatVibrationToggleProps };
+export type { ChatSoundAndVibrationPanelProps };
 export type { ChatEffect };
 export type { ChatEffectConfig };
 export type { ChatEffectsSystemProps };

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

@@ -12,6 +12,12 @@ import { isValidXmlString } from '../formats/xml/utils/isValidXmlString';
 import { PromptString } from '../pipeline/prompt-notation';
 import { prompt } from '../pipeline/prompt-notation';
 import { promptTemplate } from '../pipeline/prompt-notation';
+import { CLIENT_VERSION_HEADER } from '../utils/clientVersion';
+import { CLIENT_LATEST_VERSION } from '../utils/clientVersion';
+import { isClientVersionCompatible } from '../utils/clientVersion';
+import { formatClientVersionMismatchMessage } from '../utils/clientVersion';
+import { attachClientVersionHeader } from '../utils/clientVersion';
+import { getClientVersionFromHeaders } from '../utils/clientVersion';
 import { $detectRuntimeEnvironment } from '../utils/environment/$detectRuntimeEnvironment';
 import { $isRunningInBrowser } from '../utils/environment/$isRunningInBrowser';
 import { $isRunningInJest } from '../utils/environment/$isRunningInJest';
@@ -103,6 +109,12 @@ export { isValidXmlString };
 export { PromptString };
 export { prompt };
 export { promptTemplate };
+export { CLIENT_VERSION_HEADER };
+export { CLIENT_LATEST_VERSION };
+export { isClientVersionCompatible };
+export { formatClientVersionMismatchMessage };
+export { attachClientVersionHeader };
+export { getClientVersionFromHeaders };
 export { $detectRuntimeEnvironment };
 export { $isRunningInBrowser };
 export { $isRunningInJest };

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

@@ -0,0 +1,18 @@
+import type { BookCommitment } from '../../commitments/_base/BookCommitment';
+/**
+ * Resolves compact agent references that appear inside FROM, IMPORT, and TEAM commitments.
+ *
+ * Implementations are expected to rewrite reference tokens such as `{Activation code agent}`
+ * or `@Superagent` into concrete agent URLs before the commitment is applied.
+ *
+ * @private @@@
+ */
+export type AgentReferenceResolver = {
+    /**
+     * Normalizes the content of a commitment before it is applied to the model requirements.
+     *
+     * @param commitmentType - The commitment keyword (e.g. FROM, IMPORT, TEAM)
+     * @param content - Original payload of the commitment
+     */
+    resolveCommitmentContent(commitmentType: BookCommitment, content: string): Promise<string>;
+};

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

@@ -0,0 +1,41 @@
+import type { string_book } from './string_book';
+/**
+ * Helper for manipulating agent books in-memory.
+ *
+ * @private internal helper for `@promptbook/core`
+ */
+export declare class BookEditable {
+    private readonly lines;
+    /**
+     * Creates a mutable view over the supplied book content.
+     *
+     * @param book - Agent source text to work with.
+     */
+    constructor(book: string_book);
+    /**
+     * Creates a new instance from the supplied book text.
+     *
+     * @param book - Agent source text to work with.
+     * @returns Editable view over the book content.
+     */
+    static from(book: string_book): BookEditable;
+    /**
+     * Returns the editable content as a string_book.
+     *
+     * @returns Current book content with original line breaks preserved.
+     */
+    toString(): string_book;
+    /**
+     * Checks whether the book contains any non-empty lines.
+     *
+     * @returns `true` when the book has meaningful content beyond blank lines.
+     */
+    hasNonEmptyContent(): boolean;
+    /**
+     * Finds the last line index whose trimmed text matches the commitment name.
+     *
+     * @param commitment - Commitment keyword to locate (for example `CLOSED`).
+     * @returns Zero-based line index or `null` when the commitment is absent.
+     */
+    findLastCommitmentLineIndex(commitment: string): number | null;
+}

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

@@ -0,0 +1,17 @@
+import type { AgentReferenceResolver } from './AgentReferenceResolver';
+import type { InlineKnowledgeSourceUploader } from '../../utils/knowledge/inlineKnowledgeSource';
+/**
+ * Options for `createAgentModelRequirements` and `createAgentModelRequirementsWithCommitments`.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export type CreateAgentModelRequirementsOptions = {
+    /**
+     * Resolver that transforms compact agent references (FROM, IMPORT, TEAM) into concrete URLs.
+     */
+    readonly agentReferenceResolver?: AgentReferenceResolver;
+    /**
+     * Optional hook used to upload inline knowledge files before finalizing the requirements.
+     */
+    readonly inlineKnowledgeSourceUploader?: InlineKnowledgeSourceUploader;
+};

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

@@ -2,17 +2,23 @@ import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { string_agent_name, string_model_name, string_system_message, string_url_image } from '../../types/typeAliases';
 import type { AgentModelRequirements } from './AgentModelRequirements';
+import type { CreateAgentModelRequirementsOptions } from './CreateAgentModelRequirementsOptions';
 import type { string_book } from './string_book';
 /**
- * Creates model requirements for an agent based on its source
+ * Creates model requirements for an agent based on its source.
  *
  * There are 2 similar functions:
  * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
  * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronous.
  *
+ * @param agentSource - Book describing the agent.
+ * @param modelName - Optional override for the agent's model.
+ * @param availableModels - Models that could fulfill the agent.
+ * @param llmTools - Execution tools used when selecting a best model.
+ * @param options - Optional hooks such as the agent reference resolver.
  * @public exported from `@promptbook/core`
  */
-export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string_model_name, availableModels?: readonly AvailableModel[], llmTools?: LlmExecutionTools): Promise<AgentModelRequirements>;
+export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string_model_name, availableModels?: readonly AvailableModel[], llmTools?: LlmExecutionTools, options?: CreateAgentModelRequirementsOptions): Promise<AgentModelRequirements>;
 /**
  * Extracts MCP servers from agent source
  *

package/esm/typings/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.agentReferenceResolver.test.d.ts

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

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

@@ -1,11 +1,10 @@
 import type { string_model_name } from '../../types/typeAliases';
 import type { AgentModelRequirements } from './AgentModelRequirements';
+import type { CreateAgentModelRequirementsOptions } from './CreateAgentModelRequirementsOptions';
 import type { string_book } from './string_book';
 /**
- * Creates agent model requirements using the new commitment system
- * This function uses a reduce-like pattern where each commitment applies its changes
- * to build the final requirements starting from a basic empty model
+ * @@@
  *
- * @public exported from `@promptbook/core`
+ * @private @@@
  */
-export declare function createAgentModelRequirementsWithCommitments(agentSource: string_book, modelName?: string_model_name): Promise<AgentModelRequirements>;
+export declare function createAgentModelRequirementsWithCommitments(agentSource: string_book, modelName?: string_model_name, options?: CreateAgentModelRequirementsOptions): Promise<AgentModelRequirements>;

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

@@ -2,6 +2,43 @@ import { CSSProperties } from 'react';
 import type { Promisable } from 'type-fest';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
 import type { number_percent, number_positive, string_css_value, string_knowledge_source_content } from '../../types/typeAliases';
+/**
+ * Monaco diagnostic shown inside `BookEditor`.
+ *
+ * @private internal type of `BookEditor`
+ */
+type BookEditorDiagnostic = {
+    /**
+     * 1-based start line.
+     */
+    readonly startLineNumber: number;
+    /**
+     * 1-based start column.
+     */
+    readonly startColumn: number;
+    /**
+     * 1-based end line.
+     */
+    readonly endLineNumber: number;
+    /**
+     * 1-based end column.
+     */
+    readonly endColumn: number;
+    /**
+     * Diagnostic message shown by Monaco.
+     */
+    readonly message: string;
+    /**
+     * Marker severity used for color coding in Monaco.
+     *
+     * @default 'error'
+     */
+    readonly severity?: 'error' | 'warning' | 'info' | 'hint';
+    /**
+     * Optional source label shown in Monaco hover.
+     */
+    readonly source?: string;
+};
 /**
  * Default height of the book editor
  *
@@ -76,6 +113,10 @@ export type BookEditorProps = {
      * Callback function to handle changes in the book content.
      */
     onChange?(value: string_book): void;
+    /**
+     * Optional Monaco diagnostics shown as squiggle markers in the editor.
+     */
+    readonly diagnostics?: ReadonlyArray<BookEditorDiagnostic>;
     /**
      * Returns the URL of the uploaded file on CDN or storage.
      */
@@ -162,6 +203,7 @@ export type BookEditorProps = {
  * @public exported from `@promptbook/components`
  */
 export declare function BookEditor(props: BookEditorProps): import("react/jsx-runtime").JSX.Element;
+export {};
 /**
  * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
  */

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

@@ -3,7 +3,6 @@ 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';
-import type { ChatSoundSystem } from './ChatProps';
 /**
  * Props for the Chat actions toolbar.
  *
@@ -26,7 +25,6 @@ export type ChatActionsBarProps = {
      */
     shouldDisableActions: boolean;
     onButtonClick: (handler?: (event: MouseEvent<HTMLButtonElement>) => void) => (event: MouseEvent<HTMLButtonElement>) => void;
-    soundSystem?: ChatSoundSystem;
 };
 /**
  * Renders the action buttons row for Chat.

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

@@ -6,6 +6,17 @@ import { string_color } from '../../../types/typeAliases';
 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';
+/**
+ * Response data returned by the optional `onFeedback` handler.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type ChatFeedbackResponse = {
+    /**
+     * Optional text that should be shown to the user after the feedback is saved.
+     */
+    readonly message?: string;
+};
 /**
  * Interface for sound system that can be passed to Chat component
  * This allows the chat to trigger sounds without tight coupling

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

@@ -40,3 +40,15 @@ export type ChatVibrationToggleProps = {
  * @public exported from `@promptbook/components`
  */
 export declare function ChatVibrationToggle(props: ChatVibrationToggleProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Props for the combined sound and vibration control panel.
+ */
+export type ChatSoundAndVibrationPanelProps = {
+    readonly soundSystem: ChatSoundSystem;
+};
+/**
+ * Renders a compact control panel that surfaces both sound and haptic toggles with richer affordances.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function ChatSoundAndVibrationPanel(props: ChatSoundAndVibrationPanelProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,21 @@
+/**
+ * Props for rendering an interactive image prompt placeholder.
+ *
+ * @private internal component of `<ChatMessageItem/>`
+ */
+export type ImagePromptRendererProps = {
+    /**
+     * Alt text provided by the agent for the image.
+     */
+    alt: string;
+    /**
+     * Prompt text that will be sent to the image generation API.
+     */
+    prompt: string;
+};
+/**
+ * Renders a preview area for the `![alt](?image-prompt=...)` notation.
+ *
+ * @private internal component of `<ChatMessageItem/>`
+ */
+export declare function ImagePromptRenderer({ alt, prompt }: ImagePromptRendererProps): import("react/jsx-runtime").JSX.Element;

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

@@ -68,6 +68,11 @@ export type LlmChatProps = Omit<ChatProps, 'messages' | 'onMessage' | 'onChange'
      * @default Shared thinking message variants
      */
     readonly thinkingMessages?: ReadonlyArray<string>;
+    /**
+     * Human-friendly text shown when `LlmChat` fails to process a message.
+     * Use metadata overrides in apps (like Agents Server) instead of copying this string.
+     */
+    readonly chatFailMessage?: string;
     /**
      * Optional custom error handler that will be called when an error occurs during chat.
      * If not provided, errors will be displayed as messages in the chat.

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

@@ -0,0 +1,9 @@
+/**
+ * Default user-facing error text shown in chats when the generator fails.
+ *
+ * @private internal fallback for `LlmChat` so the same string can be reused across the stack without repetition.
+ */
+export declare const DEFAULT_CHAT_FAIL_MESSAGE = "Sorry, I encountered an error processing your message. Please, try again later.";
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

@@ -1,6 +1,7 @@
 import type { Promisable } from 'type-fest';
 import type { id } from '../../../types/typeAliases';
 import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatFeedbackResponse } from '../Chat/ChatProps';
 /**
  * Input parameters for the chat rating hook.
  *
@@ -21,12 +22,33 @@ export type UseChatRatingsOptions = {
         chatThread: string;
         expectedAnswer: string | null;
         url: string;
-    }) => Promisable<void>;
+    }) => Promisable<ChatFeedbackResponse | void>;
     /**
      * Whether the UI should apply mobile-specific behavior.
      */
     isMobile: boolean;
 };
+/**
+ * Indicates how the feedback status message should be rendered.
+ *
+ * @private component of `<Chat/>`
+ */
+export type FeedbackStatusVariant = 'success' | 'error';
+/**
+ * Data used to show the transient feedback status toast.
+ *
+ * @private component of `<Chat/>`
+ */
+export type FeedbackStatus = {
+    /**
+     * Message displayed to the user.
+     */
+    readonly message: string;
+    /**
+     * Whether the message indicates success or failure.
+     */
+    readonly variant: FeedbackStatusVariant;
+};
 /**
  * Rating state tracked for the chat UI.
  *
@@ -39,7 +61,7 @@ export type ChatRatingsState = {
     textRating: string;
     hoveredRating: number;
     expandedMessageId: id | null;
-    ratingConfirmation: string | null;
+    feedbackStatus: FeedbackStatus | null;
 };
 /**
  * Rating actions for the chat UI.

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

@@ -27,7 +27,7 @@ export type ChatSaveFormatDefinition = {
     /**
      * The function that generates the content of the file to be saved
      */
-    getContent(chatExportData: ChatExportData): Promisable<string>;
+    getContent(chatExportData: ChatExportData): Promisable<ChatSaveFormatContent>;
 };
 /**
  * Plugin contract for the data passed to `ChatSaveFormatDefinition.getContent()`
@@ -48,4 +48,10 @@ type ChatExportData = {
      */
     readonly participants: ReadonlyArray<ChatParticipant>;
 };
+/**
+ * Content data that can be wrapped into a browser blob.
+ *
+ * @private Internal helper type for chat save plugins.
+ */
+type ChatSaveFormatContent = string | Blob | ArrayBuffer | ArrayBufferView;
 export {};

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

@@ -1,3 +1,5 @@
+import type { ChatMessage } from '../../types/ChatMessage';
+import type { ChatParticipant } from '../../types/ChatParticipant';
 /**
  * HTML export plugin
  *
@@ -6,15 +8,14 @@
 export declare const htmlSaveFormatDefinition: {
     readonly formatName: "html";
     readonly label: "Html";
-    readonly getContent: ({ messages }: {
+    readonly getContent: ({ title, messages, participants }: {
         readonly title: string;
-        readonly messages: readonly import("../../types/ChatMessage").ChatMessage[];
-        readonly participants: readonly import("../../types/ChatParticipant").ChatParticipant[];
+        readonly messages: readonly ChatMessage[];
+        readonly participants: readonly ChatParticipant[];
     }) => string;
     readonly mimeType: "text/html";
     readonly fileExtension: "html";
 };
 /**
- * TODO: !!! Add QR code with branding to the footer
- *  TODO: [😬] Take chat save to HTML from existing parallel implementation
+ * TODO: Enhance branding
  */

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

@@ -36,7 +36,7 @@ export declare const CHAT_SAVE_FORMATS: readonly [{
 }, {
     readonly formatName: "html";
     readonly label: "Html";
-    readonly getContent: ({ messages }: {
+    readonly getContent: ({ title, messages, participants }: {
         readonly title: string;
         readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
         readonly participants: readonly import("../types/ChatParticipant").ChatParticipant[];
@@ -56,11 +56,11 @@ export declare const CHAT_SAVE_FORMATS: readonly [{
 }, {
     readonly formatName: "pdf";
     readonly label: "Pdf";
-    readonly getContent: (chatExportData: {
+    readonly getContent: ({ messages, participants }: {
         readonly title: string;
         readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
         readonly participants: readonly import("../types/ChatParticipant").ChatParticipant[];
-    }) => Promise<string>;
+    }) => Uint8Array;
     readonly mimeType: "application/pdf";
     readonly fileExtension: "pdf";
 }];

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

@@ -0,0 +1,11 @@
+import type { ChatMessage } from '../../types/ChatMessage';
+import type { ChatParticipant } from '../../types/ChatParticipant';
+/**
+ * Creates a minimal PDF representation of the provided chat.
+ *
+ * @param messages - Messages that should be included in the PDF export.
+ * @param participants - Optional participant metadata to resolve sender names.
+ * @returns Binary data for the generated PDF file.
+ * @private Internal helper used by `pdfSaveFormatDefinition`.
+ */
+export declare function buildChatPdf(messages: ReadonlyArray<ChatMessage>, participants?: ReadonlyArray<ChatParticipant>): Uint8Array;

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

@@ -6,11 +6,11 @@
 export declare const pdfSaveFormatDefinition: {
     readonly formatName: "pdf";
     readonly label: "Pdf";
-    readonly getContent: (chatExportData: {
+    readonly getContent: ({ messages, participants }: {
         readonly title: string;
         readonly messages: readonly import("../../types/ChatMessage").ChatMessage[];
         readonly participants: readonly import("../../types/ChatParticipant").ChatParticipant[];
-    }) => Promise<string>;
+    }) => Uint8Array;
     readonly mimeType: "application/pdf";
     readonly fileExtension: "pdf";
 };

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

@@ -7,19 +7,13 @@ import type { AgentChipData } from '../AgentChip';
  */
 export type ToolCallChipletInfo = {
     /**
-     * Display text for the chiplet
+     * Display text for the chiplet.
      */
     text: string;
     /**
-     * Agent data for team tools (if applicable)
+     * Agent data for team tools (if applicable).
      */
     agentData?: AgentChipData;
-    /**
-     * Whether to wrap the chip text in brackets when rendering.
-     *
-     * @default true
-     */
-    wrapInBrackets?: boolean;
 };
 /**
  * Builds display text for a tool call chiplet.
@@ -33,12 +27,10 @@ export declare function buildToolCallChipText(chipletInfo: ToolCallChipletInfo):
  * Technical to user-friendly tool names and emojis
  *
  * @private utility of `<Chat/>` [🧠] Maybe public?
- *
  */
 export declare const TOOL_TITLES: Record<string, {
     title: string;
     emoji: string;
-    wrapInBrackets?: boolean;
 }>;
 /**
  * Gets the chiplet information including text and agent data (for team tools).

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

@@ -0,0 +1,75 @@
+/**
+ * Default citation identifier used for simplified citation markers without an explicit position.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare const DEFAULT_SIMPLIFIED_CITATION_ID = "0:0";
+/**
+ * Parsed citation marker normalized to the full OpenAI-style notation.
+ *
+ * @private utility of `<Chat/>`
+ */
+export type CitationMarker = {
+    /**
+     * Citation identifier (for example `7:15`).
+     */
+    id: string;
+    /**
+     * Citation source filename or label.
+     */
+    source: string;
+    /**
+     * Original marker exactly as found in the content.
+     */
+    raw: string;
+    /**
+     * Full normalized marker (`【id†source】`).
+     */
+    normalized: string;
+};
+/**
+ * Creates a global regular expression that matches citation markers wrapped in `【...】`.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function createCitationMarkerRegex(): RegExp;
+/**
+ * Parses one citation marker and normalizes it to full notation.
+ *
+ * @param rawMarker - Marker including outer brackets.
+ * @returns Parsed marker or `null` when the marker is invalid.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function parseCitationMarker(rawMarker: string): CitationMarker | null;
+/**
+ * Parses all citation markers from content and normalizes each to full notation.
+ *
+ * @param content - Content that may contain citation markers.
+ * @returns Parsed citation markers in their original order.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function parseCitationMarkersFromContent(content: string): CitationMarker[];
+/**
+ * Replaces all citation markers in content using normalized marker metadata.
+ *
+ * @param content - Content that may contain citation markers.
+ * @param replacer - Replacement callback for each valid marker.
+ * @returns Content with citation markers replaced.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function replaceCitationMarkers(content: string, replacer: (marker: CitationMarker) => string): string;
+/**
+ * Normalizes simplified citation markers to full notation.
+ *
+ * Example:
+ * - `【document.pdf】` -> `【0:0†document.pdf】`
+ *
+ * @param content - Content that may contain simplified markers.
+ * @returns Content where every citation marker is in full notation.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function normalizeCitationMarkersToFullNotation(content: string): string;

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

@@ -22,7 +22,9 @@ export type ParsedCitation = {
 };
 /**
  * Parses OpenAI Assistant-style citations from message content
- * Matches patterns like: 【5:13†document.pdf】
+ * Matches both:
+ * - Full notation: `【5:13†document.pdf】`
+ * - Simplified notation: `【document.pdf】`
  *
  * @param content - The markdown content that may contain citations
  * @returns Array of parsed citations

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * Segment representing parts of a chat message that contain either raw text or an image prompt.
+ *
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+export type ImagePromptSegment = ImagePromptTextSegment | ImagePromptImageSegment;
+/**
+ * Raw text segment that can be rendered as markdown.
+ *
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+export type ImagePromptTextSegment = {
+    type: 'text';
+    content: string;
+};
+/**
+ * Image prompt segment that needs to fire the image generation pipeline.
+ *
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+export type ImagePromptImageSegment = {
+    type: 'image';
+    /**
+     * Accessible alt text provided by the agent.
+     */
+    alt: string;
+    /**
+     * Prompt text that will be sent to the image generation API.
+     */
+    prompt: string;
+};
+/**
+ * Splits a chat message into text and image prompt segments.
+ *
+ * @param content - Raw markdown string produced by the agent.
+ * @returns Ordered list of segments that preserves the original message flow.
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+export declare function splitMessageContentByImagePrompts(content: string): ReadonlyArray<ImagePromptSegment>;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

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

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

@@ -1,9 +1,22 @@
+/**
+ * Supported arrow directions.
+ *
+ * @private internal typing helper for `<ArrowIcon/>`
+ */
+type ArrowDirection = 'DOWN' | 'UP';
+/**
+ * Props for rendering a directional arrow icon.
+ *
+ * @private internal props typing for `<ArrowIcon/>`
+ */
+type ArrowIconProps = {
+    direction: ArrowDirection;
+    size: number;
+};
 /**
  * Shows simple arrow icon pointing up or down
  *
  * @public exported from `@promptbook/components`
  */
-export declare const ArrowIcon: ({ direction, size }: {
-    direction: string;
-    size: number;
-}) => import("react/jsx-runtime").JSX.Element;
+export declare const ArrowIcon: ({ direction, size }: ArrowIconProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/esm/typings/src/commitments/MEMORY/MEMORY.d.ts

@@ -1,5 +1,63 @@
+import { string_javascript_name } from '../../_packages/types.index';
 import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * Memory record returned by runtime adapters.
+ *
+ * @private internal MEMORY commitment types
+ */
+export type MemoryToolRecord = {
+    id?: string;
+    content: string;
+    isGlobal: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+};
+/**
+ * Runtime context for MEMORY tools resolved from hidden tool arguments.
+ *
+ * @private internal MEMORY commitment types
+ */
+export type MemoryToolRuntimeContext = {
+    readonly enabled: boolean;
+    readonly userId?: number;
+    readonly username?: string;
+    readonly agentId?: string;
+    readonly agentName?: string;
+    readonly isTeamConversation: boolean;
+};
+/**
+ * Runtime adapter interface used by MEMORY tools.
+ *
+ * @private internal MEMORY commitment types
+ */
+export type MemoryToolRuntimeAdapter = {
+    retrieveMemories(args: {
+        query?: string;
+        limit?: number;
+    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord[]>;
+    storeMemory(args: {
+        content: string;
+        isGlobal: boolean;
+    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord>;
+    updateMemory(args: {
+        memoryId: string;
+        content: string;
+        isGlobal?: boolean;
+    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord>;
+    deleteMemory(args: {
+        memoryId: string;
+    }, runtimeContext: MemoryToolRuntimeContext): Promise<{
+        id?: string;
+    }>;
+};
+/**
+ * Sets runtime adapter used by MEMORY commitment tools.
+ *
+ * @private internal runtime wiring for MEMORY commitment
+ */
+export declare function setMemoryToolRuntimeAdapter(adapter: MemoryToolRuntimeAdapter | null): void;
 /**
  * MEMORY commitment definition
  *
@@ -19,6 +77,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  */
 export declare class MemoryCommitmentDefinition extends BaseCommitmentDefinition<'MEMORY' | 'MEMORIES'> {
     constructor(type?: 'MEMORY' | 'MEMORIES');
+    get requiresContent(): boolean;
     /**
      * Short one-line description of MEMORY.
      */
@@ -32,6 +91,14 @@ export declare class MemoryCommitmentDefinition extends BaseCommitmentDefinition
      */
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Gets human-readable titles for MEMORY tool functions.
+     */
+    getToolTitles(): Record<string_javascript_name, string>;
+    /**
+     * Gets MEMORY tool function implementations.
+     */
+    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
 }
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/commitments/MEMORY/MEMORY.test.d.ts

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

package/esm/typings/src/commitments/_common/toolRuntimeContext.d.ts

@@ -0,0 +1,49 @@
+import { TODO_any } from '../../_packages/types.index';
+/**
+ * Prompt parameter key used to pass hidden runtime context to tool execution.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+export declare const TOOL_RUNTIME_CONTEXT_PARAMETER = "promptbookToolRuntimeContext";
+/**
+ * Hidden argument key used to pass runtime context into individual tool calls.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+export declare const TOOL_RUNTIME_CONTEXT_ARGUMENT = "__promptbookToolRuntimeContext";
+/**
+ * Runtime context shape shared across commitment tools.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+export type ToolRuntimeContext = {
+    memory?: {
+        enabled?: boolean;
+        userId?: number;
+        username?: string;
+        agentId?: string;
+        agentName?: string;
+        isTeamConversation?: boolean;
+    };
+};
+/**
+ * Parses unknown runtime context payload into a normalized object.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+export declare function parseToolRuntimeContext(rawValue: unknown): ToolRuntimeContext | null;
+/**
+ * Reads runtime context attached to tool call arguments.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+export declare function readToolRuntimeContextFromToolArgs(args: Record<string, TODO_any>): ToolRuntimeContext | null;
+/**
+ * Serializes runtime context for prompt parameters.
+ *
+ * @private internal runtime wiring for commitment tools
+ */
+export declare function serializeToolRuntimeContext(context: ToolRuntimeContext): string;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/constants/streaming.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Keep-alive helpers used for streaming chat responses.
+ *
+ * These constants coordinate the signal sent by the Agents Server streaming
+ * endpoint and the parser in the SDK so we can distinguish between
+ * real content and occasional pings.
+ *
+ * @private internal streaming helper for Promptbook chat connections
+ */
+export declare const CHAT_STREAM_KEEP_ALIVE_TOKEN = "STREAM_KEEP_ALIVE";
+/**
+ * Interval (milliseconds) between keep-alive pings emitted while the chat server
+ * is still composing the reply.
+ *
+ * @private internal streaming helper for Promptbook chat connections
+ */
+export declare const CHAT_STREAM_KEEP_ALIVE_INTERVAL_MS = 25000;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/llm-providers/openai/utils/buildToolInvocationScript.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Builds a tool invocation script that injects hidden runtime context into tool args.
+ *
+ * @private utility of OpenAI tool execution wrappers
+ */
+export declare function buildToolInvocationScript(options: {
+    readonly functionName: string;
+    readonly functionArgsExpression: string;
+}): string;

package/esm/typings/src/utils/clientVersion.d.ts

@@ -0,0 +1,51 @@
+/**
+ * HTTP header used by Promptbook clients to advertise their release version.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare const CLIENT_VERSION_HEADER = "x-promptbook-client-version";
+/**
+ * The latest client (engine) version that the server expects.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare const CLIENT_LATEST_VERSION: string;
+/**
+ * Determines if the provided version string exactly matches the latest release.
+ *
+ * @param version - Version string obtained from a request header.
+ * @returns True when the version equals `CLIENT_LATEST_VERSION`.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function isClientVersionCompatible(version: unknown): version is string;
+/**
+ * Formats the message that should be shown when a client is out of date.
+ *
+ * @param clientVersion - The version reported by the client (optional).
+ * @returns User-facing text explaining how to fix the mismatch.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function formatClientVersionMismatchMessage(clientVersion?: string | null): string;
+/**
+ * Creates a headers object that includes the client version header.
+ *
+ * @param headers - Optional base headers to clone.
+ * @returns New headers object augmented with `CLIENT_VERSION_HEADER`.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function attachClientVersionHeader<T extends Record<string, string> = Record<string, string>>(headers?: T): T & Record<typeof CLIENT_VERSION_HEADER, string>;
+/**
+ * Normalizes the client version reported inside a `HeadersInit` object.
+ *
+ * @param headers - Headers collection to read from.
+ * @returns The trimmed client version or `null` when it is missing.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function getClientVersionFromHeaders(headers?: HeadersInit): string | null;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/utils/knowledge/inlineKnowledgeSource.d.ts

@@ -1,20 +1,20 @@
 /// <reference types="node" />
 /// <reference types="node" />
-import type { string_data_url, string_filename } from '../../types/typeAliases';
+import type { string_data_url, string_filename, string_knowledge_source_link } from '../../types/typeAliases';
 /**
- * @@@
- *
- * @private thing of inline knowledge
+ * @private Internal representation of inline knowledge prepared for uploads.
  */
 export type InlineKnowledgeSourceFile = {
     readonly filename: string_filename;
     readonly mimeType: string;
-    readonly url: string_data_url;
+    readonly buffer: Buffer;
 };
 /**
- * Creates a data URL that represents the inline knowledge content as a text file.
- *
- * @private thing of inline knowledge
+ * @private Function signature used to upload inline knowledge files to external storage.
+ */
+export type InlineKnowledgeSourceUploader = (file: InlineKnowledgeSourceFile) => Promise<string_knowledge_source_link>;
+/**
+ * @private Converts inline knowledge into the internal metadata form used for uploads.
  */
 export declare function createInlineKnowledgeSourceFile(content: string): InlineKnowledgeSourceFile;
 /**
@@ -23,10 +23,14 @@ export declare function createInlineKnowledgeSourceFile(content: string): Inline
  * @private thing of inline knowledge
  */
 export declare function isDataUrlKnowledgeSource(source: string): source is string_data_url;
+/**
+ * @private Converts a stored inline knowledge file into a data URL for backwards compatibility.
+ */
+export declare function inlineKnowledgeSourceToDataUrl(source: InlineKnowledgeSourceFile): string_knowledge_source_link;
 /**
  * Parses a data URL-based knowledge source into its raw buffer, filename, and MIME type.
  *
- * @private thing of inline knowledge
+ * @private utility of inline knowledge processing
  */
 export declare function parseDataUrlKnowledgeSource(source: string): {
     readonly buffer: Buffer;

package/esm/typings/src/utils/normalization/constructImageFilename.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Constructs a standardized filename for a generated image based on its prompt and parameters.
+ *
+ * @param params - The parameters for the image generation
+ * @returns The constructed filename
+ *
+ * @private internal helper for image generation pipeline
+ */
+export declare function constructImageFilename(params: {
+    prompt: string;
+    model?: string;
+    size?: string;
+    quality?: string;
+    style?: string;
+    attachments?: Array<{
+        url: string;
+    }>;
+}): string;

package/esm/typings/src/utils/normalization/constructImageFilename.test.d.ts

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

package/esm/typings/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.110.0-8`).
+ * It follows semantic versioning (e.g., `0.110.0`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/javascript",
-    "version": "0.110.0-9",
+    "version": "0.111.0-0",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -97,7 +97,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/javascript.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.110.0-9"
+        "@promptbook/core": "0.111.0-0"
     },
     "dependencies": {
         "crypto": "1.0.1",

package/umd/index.umd.js

@@ -22,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.110.0-9';
+    const PROMPTBOOK_ENGINE_VERSION = '0.111.0-0';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name