@promptbook/components 0.111.0-4 → 0.111.0-7

package/esm/index.es.js

@@ -8,7 +8,6 @@ import { randomBytes } from 'crypto';
 import moment from 'moment';
 import { createPortal } from 'react-dom';
 import Editor, { useMonaco } from '@monaco-editor/react';
-import { MarkerSeverity } from 'monaco-editor';
 import { Registration } from 'destroyable';
 import katex from 'katex';
 import { createRoot } from 'react-dom/client';
@@ -42,7 +41,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.111.0-4';
+const PROMPTBOOK_ENGINE_VERSION = '0.111.0-7';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -526,6 +525,188 @@ function checkChannelValue(channelName, value) {
     }
 }
 
+const SHORT_HEX_LENGTHS = new Set([3, 4]);
+const LONG_HEX_LENGTHS = new Set([6, 8]);
+/**
+ * Parses a hex string into RGBA channel values.
+ *
+ * @param hex - Hex value such as `#09d`, `009edd`, `#009eddff`.
+ * @returns RGBA channel values.
+ *
+ * @private function of Color
+ */
+function parseHexColor(hex) {
+    const sanitized = hex.startsWith('#') ? hex.substring(1) : hex;
+    const throwInvalidHex = () => {
+        throw new Error(`Can not parse color from hex string "${hex}"`);
+    };
+    if (SHORT_HEX_LENGTHS.has(sanitized.length)) {
+        return {
+            red: parseShortHexChannel(sanitized.charAt(0), throwInvalidHex),
+            green: parseShortHexChannel(sanitized.charAt(1), throwInvalidHex),
+            blue: parseShortHexChannel(sanitized.charAt(2), throwInvalidHex),
+            alpha: sanitized.length === 4 ? parseShortHexChannel(sanitized.charAt(3), throwInvalidHex) : 255,
+        };
+    }
+    if (LONG_HEX_LENGTHS.has(sanitized.length)) {
+        return {
+            red: parseLongHexChannel(sanitized, 0, throwInvalidHex),
+            green: parseLongHexChannel(sanitized, 2, throwInvalidHex),
+            blue: parseLongHexChannel(sanitized, 4, throwInvalidHex),
+            alpha: sanitized.length === 8 ? parseLongHexChannel(sanitized, 6, throwInvalidHex) : 255,
+        };
+    }
+    return throwInvalidHex();
+}
+function parseShortHexChannel(char, onError) {
+    if (!char) {
+        return onError();
+    }
+    const parsed = parseInt(char, 16);
+    if (Number.isNaN(parsed)) {
+        return onError();
+    }
+    return parsed * 16;
+}
+function parseLongHexChannel(hex, start, onError) {
+    const segment = hex.substr(start, 2);
+    if (segment.length < 2) {
+        return onError();
+    }
+    const parsed = parseInt(segment, 16);
+    if (Number.isNaN(parsed)) {
+        return onError();
+    }
+    return parsed;
+}
+
+const HSL_REGEX = /^hsl\(\s*([0-9.]+)\s*,\s*([0-9.]+)%\s*,\s*([0-9.]+)%\s*\)$/;
+/**
+ * Parses an HSL string into RGBA channel values.
+ *
+ * @param hsl - HSL string such as `hsl(197.1, 100%, 43.3%)`.
+ * @returns RGBA channel values.
+ *
+ * @private function of Color
+ */
+function parseHslColor(hsl) {
+    const match = hsl.match(HSL_REGEX);
+    if (!match) {
+        throw new Error(`Invalid hsl string format: "${hsl}"`);
+    }
+    const hue = parseFloat(match[1]);
+    const saturation = parseFloat(match[2]) / 100;
+    const lightness = parseFloat(match[3]) / 100;
+    const { red, green, blue } = convertHslToRgb(hue, saturation, lightness);
+    return {
+        red,
+        green,
+        blue,
+        alpha: 255,
+    };
+}
+function convertHslToRgb(h, s, l) {
+    const c = (1 - Math.abs(2 * l - 1)) * s;
+    const x = c * (1 - Math.abs(((h / 60) % 2) - 1));
+    const m = l - c / 2;
+    let r1 = 0;
+    let g1 = 0;
+    let b1 = 0;
+    if (h >= 0 && h < 60) {
+        r1 = c;
+        g1 = x;
+    }
+    else if (h >= 60 && h < 120) {
+        r1 = x;
+        g1 = c;
+    }
+    else if (h >= 120 && h < 180) {
+        g1 = c;
+        b1 = x;
+    }
+    else if (h >= 180 && h < 240) {
+        g1 = x;
+        b1 = c;
+    }
+    else if (h >= 240 && h < 300) {
+        r1 = x;
+        b1 = c;
+    }
+    else if (h >= 300 && h < 360) {
+        r1 = c;
+        b1 = x;
+    }
+    return {
+        red: Math.round((r1 + m) * 255),
+        green: Math.round((g1 + m) * 255),
+        blue: Math.round((b1 + m) * 255),
+    };
+}
+
+const RGB_REGEX = /^rgb\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
+const RGBA_REGEX = /^rgba\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
+/**
+ * Parses an RGB string into RGBA channel values.
+ *
+ * @param rgb - RGB string such as `rgb(0%, 62%, 86.7%)`.
+ * @returns RGBA channel values.
+ *
+ * @private function of Color
+ */
+function parseRgbColor(rgb) {
+    const match = rgb.match(RGB_REGEX);
+    if (!match) {
+        throw new Error(`Invalid rgb string format: "${rgb}"`);
+    }
+    return {
+        red: parseChannelValue(match[1]),
+        green: parseChannelValue(match[2]),
+        blue: parseChannelValue(match[3]),
+        alpha: 255,
+    };
+}
+/**
+ * Parses an RGBA string into RGBA channel values.
+ *
+ * @param rgba - RGBA string such as `rgba(0, 158, 221, 0.5)`.
+ * @returns RGBA channel values.
+ *
+ * @private function of Color
+ */
+function parseRgbaColor(rgba) {
+    const match = rgba.match(RGBA_REGEX);
+    if (!match) {
+        throw new Error(`Invalid rgba string format: "${rgba}"`);
+    }
+    return {
+        red: parseChannelValue(match[1]),
+        green: parseChannelValue(match[2]),
+        blue: parseChannelValue(match[3]),
+        alpha: parseAlphaValue(match[4]),
+    };
+}
+function parseChannelValue(value) {
+    if (value.endsWith('%')) {
+        const percent = parseFloat(value);
+        return Math.round((percent / 100) * 255);
+    }
+    return Math.round(parseFloat(value));
+}
+function parseAlphaValue(value) {
+    if (value.endsWith('%')) {
+        const percent = parseFloat(value);
+        return Math.round((percent / 100) * 255);
+    }
+    const parsed = parseFloat(value);
+    if (parsed <= 1) {
+        return Math.round(parsed * 255);
+    }
+    return Math.round(parsed);
+}
+
+const HSL_REGEX_PATTERN = /^hsl\(\s*([0-9.]+)\s*,\s*([0-9.]+)%\s*,\s*([0-9.]+)%\s*\)$/;
+const RGB_REGEX_PATTERN = /^rgb\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
+const RGBA_REGEX_PATTERN = /^rgba\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/;
 /**
  * Color object represents an RGB color with alpha channel
  *
@@ -606,29 +787,24 @@ class Color {
      * @returns Color object
      */
     static fromString(color) {
-        if (CSS_COLORS[color]) {
-            return Color.fromString(CSS_COLORS[color]);
-            // -----
+        const trimmed = color.trim();
+        if (CSS_COLORS[trimmed]) {
+            return Color.fromString(CSS_COLORS[trimmed]);
         }
-        else if (Color.isHexColorString(color)) {
-            return Color.fromHex(color);
-            // -----
+        else if (Color.isHexColorString(trimmed)) {
+            return Color.fromHex(trimmed);
         }
-        else if (/^hsl\(\s*(\d+)\s*,\s*(\d+(?:\.\d+)?%)\s*,\s*(\d+(?:\.\d+)?%)\)$/.test(color)) {
-            return Color.fromHsl(color);
-            // -----
+        if (HSL_REGEX_PATTERN.test(trimmed)) {
+            return Color.fromHsl(trimmed);
         }
-        else if (/^rgb\((\s*[0-9-.%]+\s*,?){3}\)$/.test(color)) {
-            // TODO: [0] Should be fromRgbString and fromRgbaString one or two functions
-            return Color.fromRgbString(color);
-            // -----
+        else if (RGB_REGEX_PATTERN.test(trimmed)) {
+            return Color.fromRgbString(trimmed);
         }
-        else if (/^rgba\((\s*[0-9-.%]+\s*,?){4}\)$/.test(color)) {
-            return Color.fromRgbaString(color);
-            // -----
+        else if (RGBA_REGEX_PATTERN.test(trimmed)) {
+            return Color.fromRgbaString(trimmed);
         }
         else {
-            throw new Error(`Can not create a new Color instance from string "${color}".`);
+            throw new Error(`Can not create a new Color instance from string "${trimmed}".`);
         }
     }
     /**
@@ -659,73 +835,8 @@ class Color {
      * @returns Color object
      */
     static fromHex(hex) {
-        const hexOriginal = hex;
-        if (hex.startsWith('#')) {
-            hex = hex.substring(1);
-        }
-        if (hex.length === 3) {
-            return Color.fromHex3(hex);
-        }
-        if (hex.length === 4) {
-            return Color.fromHex4(hex);
-        }
-        if (hex.length === 6) {
-            return Color.fromHex6(hex);
-        }
-        if (hex.length === 8) {
-            return Color.fromHex8(hex);
-        }
-        throw new Error(`Can not parse color from hex string "${hexOriginal}"`);
-    }
-    /**
-     * Creates a new Color instance from color in hex format with 3 color digits (without alpha channel)
-     *
-     * @param color in hex for example `09d`
-     * @returns Color object
-     */
-    static fromHex3(hex) {
-        const r = parseInt(hex.substr(0, 1), 16) * 16;
-        const g = parseInt(hex.substr(1, 1), 16) * 16;
-        const b = parseInt(hex.substr(2, 1), 16) * 16;
-        return take(new Color(r, g, b));
-    }
-    /**
-     * Creates a new Color instance from color in hex format with 4 digits (with alpha channel)
-     *
-     * @param color in hex for example `09df`
-     * @returns Color object
-     */
-    static fromHex4(hex) {
-        const r = parseInt(hex.substr(0, 1), 16) * 16;
-        const g = parseInt(hex.substr(1, 1), 16) * 16;
-        const b = parseInt(hex.substr(2, 1), 16) * 16;
-        const a = parseInt(hex.substr(3, 1), 16) * 16;
-        return take(new Color(r, g, b, a));
-    }
-    /**
-     * Creates a new Color instance from color in hex format with 6 color digits (without alpha channel)
-     *
-     * @param color in hex for example `009edd`
-     * @returns Color object
-     */
-    static fromHex6(hex) {
-        const r = parseInt(hex.substr(0, 2), 16);
-        const g = parseInt(hex.substr(2, 2), 16);
-        const b = parseInt(hex.substr(4, 2), 16);
-        return take(new Color(r, g, b));
-    }
-    /**
-     * Creates a new Color instance from color in hex format with 8 color digits (with alpha channel)
-     *
-     * @param color in hex for example `009edd`
-     * @returns Color object
-     */
-    static fromHex8(hex) {
-        const r = parseInt(hex.substr(0, 2), 16);
-        const g = parseInt(hex.substr(2, 2), 16);
-        const b = parseInt(hex.substr(4, 2), 16);
-        const a = parseInt(hex.substr(6, 2), 16);
-        return take(new Color(r, g, b, a));
+        const { red, green, blue, alpha } = parseHexColor(hex);
+        return take(new Color(red, green, blue, alpha));
     }
     /**
      * Creates a new Color instance from color in hsl format
@@ -734,52 +845,8 @@ class Color {
      * @returns Color object
      */
     static fromHsl(hsl) {
-        const match = hsl.match(/^hsl\(\s*([0-9.]+)\s*,\s*([0-9.]+)%\s*,\s*([0-9.]+)%\s*\)$/);
-        if (!match) {
-            throw new Error(`Invalid hsl string format: "${hsl}"`);
-        }
-        const h = parseFloat(match[1]);
-        const s = parseFloat(match[2]) / 100;
-        const l = parseFloat(match[3]) / 100;
-        // HSL to RGB conversion
-        const c = (1 - Math.abs(2 * l - 1)) * s;
-        const x = c * (1 - Math.abs(((h / 60) % 2) - 1));
-        const m = l - c / 2;
-        let r1 = 0, g1 = 0, b1 = 0;
-        if (h >= 0 && h < 60) {
-            r1 = c;
-            g1 = x;
-            b1 = 0;
-        }
-        else if (h >= 60 && h < 120) {
-            r1 = x;
-            g1 = c;
-            b1 = 0;
-        }
-        else if (h >= 120 && h < 180) {
-            r1 = 0;
-            g1 = c;
-            b1 = x;
-        }
-        else if (h >= 180 && h < 240) {
-            r1 = 0;
-            g1 = x;
-            b1 = c;
-        }
-        else if (h >= 240 && h < 300) {
-            r1 = x;
-            g1 = 0;
-            b1 = c;
-        }
-        else if (h >= 300 && h < 360) {
-            r1 = c;
-            g1 = 0;
-            b1 = x;
-        }
-        const r = Math.round((r1 + m) * 255);
-        const g = Math.round((g1 + m) * 255);
-        const b = Math.round((b1 + m) * 255);
-        return take(new Color(r, g, b));
+        const { red, green, blue, alpha } = parseHslColor(hsl);
+        return take(new Color(red, green, blue, alpha));
     }
     /**
      * Creates a new Color instance from color in rgb format
@@ -788,25 +855,8 @@ class Color {
      * @returns Color object
      */
     static fromRgbString(rgb) {
-        const match = rgb.match(/^rgb\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/);
-        if (!match) {
-            throw new Error(`Invalid rgb string format: "${rgb}"`);
-        }
-        const parseChannel = (value) => {
-            if (value.endsWith('%')) {
-                // Percentage value
-                const percent = parseFloat(value);
-                return Math.round((percent / 100) * 255);
-            }
-            else {
-                // Numeric value
-                return Math.round(parseFloat(value));
-            }
-        };
-        const r = parseChannel(match[1]);
-        const g = parseChannel(match[2]);
-        const b = parseChannel(match[3]);
-        return take(new Color(r, g, b));
+        const { red, green, blue, alpha } = parseRgbColor(rgb);
+        return take(new Color(red, green, blue, alpha));
     }
     /**
      * Creates a new Color instance from color in rbga format
@@ -815,39 +865,8 @@ class Color {
      * @returns Color object
      */
     static fromRgbaString(rgba) {
-        const match = rgba.match(/^rgba\(\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*,\s*([0-9.%-]+)\s*\)$/);
-        if (!match) {
-            throw new Error(`Invalid rgba string format: "${rgba}"`);
-        }
-        const parseChannel = (value) => {
-            if (value.endsWith('%')) {
-                const percent = parseFloat(value);
-                return Math.round((percent / 100) * 255);
-            }
-            else {
-                return Math.round(parseFloat(value));
-            }
-        };
-        const parseAlpha = (value) => {
-            if (value.endsWith('%')) {
-                const percent = parseFloat(value);
-                return Math.round((percent / 100) * 255);
-            }
-            else {
-                const alphaFloat = parseFloat(value);
-                // If alpha is between 0 and 1, treat as float
-                if (alphaFloat <= 1) {
-                    return Math.round(alphaFloat * 255);
-                }
-                // Otherwise, treat as 0-255
-                return Math.round(alphaFloat);
-            }
-        };
-        const r = parseChannel(match[1]);
-        const g = parseChannel(match[2]);
-        const b = parseChannel(match[3]);
-        const a = parseAlpha(match[4]);
-        return take(new Color(r, g, b, a));
+        const { red, green, blue, alpha } = parseRgbaColor(rgba);
+        return take(new Color(red, green, blue, alpha));
     }
     /**
      * Creates a new Color for color channels values
@@ -969,14 +988,16 @@ class Color {
     }
     toHex() {
         if (this.alpha === 255) {
-            return `#${this.red.toString(16).padStart(2, '0')}${this.green.toString(16).padStart(2, '0')}${this.blue
+            return `#${this.red.toString(16).padStart(2, '0')}${this.green
                 .toString(16)
-                .padStart(2, '0')}`;
+                .padStart(2, '0')}${this.blue.toString(16).padStart(2, '0')}`;
         }
         else {
-            return `#${this.red.toString(16).padStart(2, '0')}${this.green.toString(16).padStart(2, '0')}${this.blue
+            return `#${this.red.toString(16).padStart(2, '0')}${this.green
                 .toString(16)
-                .padStart(2, '0')}${this.alpha.toString(16).padStart(2, '0')}`;
+                .padStart(2, '0')}${this.blue.toString(16).padStart(2, '0')}${this.alpha
+                .toString(16)
+                .padStart(2, '0')}`;
         }
     }
     toRgb() {
@@ -991,22 +1012,6 @@ class Color {
         throw new Error(`Getting HSL is not implemented`);
     }
 }
-/**
- * TODO: [🥻] Split Color class and color type
- * TODO: For each method a corresponding static method should be created
- *       Like clone can be done by color.clone() OR Color.clone(color)
- * TODO: Probably as an independent LIB OR add to LIB xyzt (ask @roseckyj)
- * TODO: !! Transfer back to Collboard (whole directory)
- * TODO: Maybe [🏌️‍♂️] change ACRY toString => (toHex) toRgb when there will be toRgb and toRgba united
- * TODO: Convert getters to methods - getters only for values
- * TODO: Write tests
- * TODO: Getters for alpha, opacity, transparency, r, b, g, h, s, l, a,...
- * TODO: [0] Should be fromRgbString and fromRgbaString one or two functions + one or two regex
- * TODO: Use rgb, rgba, hsl for testing and parsing with the same regex
- * TODO: Regex for rgb, rgba, hsl does not support all options like deg, rad, turn,...
- * TODO: Convolution matrix
- * TODO: Maybe connect with textures
- */
 
 /**
  * Makes color transformer which returns a grayscale version of the color
@@ -1998,6 +2003,12 @@ const RESERVED_PARAMETER_NAMES = exportJson({
         // <- TODO: Add [emoji] + instructions ACRY when adding new reserved parameter
     ],
 });
+/**
+ * Prompt parameter that toggles whether the agent runs self-learning after each chat.
+ *
+ * @public exported from `@promptbook/core`
+ */
+const PROMPT_PARAMETER_SELF_LEARNING_ENABLED = 'selfLearningEnabled';
 /**
  * Limits for IDs, names, and other strings
  *
@@ -3096,13 +3107,29 @@ function templateParameters(template, parameters) {
     return replacedTemplates;
 }
 
+/**
+ * Unsafe characters that prevent an inline parameter.
+ *
+ * @private constant of ParameterEscaping
+ */
 const INLINE_UNSAFE_PARAMETER_PATTERN = /[\r\n`$'"|<>{};()-*/~+!@#$%^&*\\/[\]]/;
+/**
+ * Characters that always need escaping for inline placeholders.
+ *
+ * @private constant of ParameterEscaping
+ */
 const PROMPT_PARAMETER_ESCAPE_PATTERN = /[`$]/g;
+/**
+ * Characters that always need escaping when braces are included.
+ *
+ * @private constant of ParameterEscaping
+ */
 const PROMPT_PARAMETER_ESCAPE_WITH_BRACES_PATTERN = /[{}$`]/g;
 /**
  * Normalizes a JSON string so it can be safely rendered without double escaping.
  *
  * @param value Candidate JSON string.
+ * @private function of ParameterEscaping
  */
 function normalizeJsonString(value) {
     try {
@@ -3114,59 +3141,35 @@ function normalizeJsonString(value) {
 }
 /**
  * Hides brackets in a string to avoid confusion with template parameters.
- */
-function hideBrackets(value) {
-    return value.split('{').join(`${REPLACING_NONCE}beginbracket`).split('}').join(`${REPLACING_NONCE}endbracket`);
-}
-/**
- * Restores brackets in a string.
- */
-function restoreBrackets(value) {
-    return value.split(`${REPLACING_NONCE}beginbracket`).join('{').split(`${REPLACING_NONCE}endbracket`).join('}');
-}
-/**
- * Prompt string wrapper to retain prompt context across interpolations.
  *
- * @public exported from `@promptbook/utils`
+ * @param value Input string with literal brackets.
+ * @private function of ParameterEscaping
  */
-class PromptString extends String {
-    /**
-     * @param value Prompt content.
-     */
-    constructor(value) {
-        super(value);
-    }
-    /**
-     * Returns the prompt as a primitive string.
-     */
-    toString() {
-        return super.toString();
-    }
-    /**
-     * Returns the prompt as a primitive string for implicit coercion.
-     */
-    valueOf() {
-        return super.valueOf();
-    }
-    /**
-     * Ensures template literal coercion returns the raw string.
-     */
-    [Symbol.toPrimitive]() {
-        return this.toString();
-    }
+function hideBrackets(value) {
+    return value
+        .split('{')
+        .join(`${REPLACING_NONCE}beginbracket`)
+        .split('}')
+        .join(`${REPLACING_NONCE}endbracket`);
 }
 /**
- * Checks whether a value is a PromptString instance.
+ * Restores hidden brackets.
  *
- * @param value Candidate value.
+ * @param value String with hidden brackets.
+ * @private function of ParameterEscaping
  */
-function isPromptString(value) {
-    return value instanceof PromptString;
+function restoreBrackets(value) {
+    return value
+        .split(`${REPLACING_NONCE}beginbracket`)
+        .join('{')
+        .split(`${REPLACING_NONCE}endbracket`)
+        .join('}');
 }
 /**
- * Decides whether a value is safe to inline directly into the prompt.
+ * Decides whether a parameter can be inlined safely.
  *
- * @param value Parameter value as string.
+ * @param value Parameter rendered as string.
+ * @private function of ParameterEscaping
  */
 function shouldInlineParameterValue(value) {
     if (value.trim() === '') {
@@ -3175,10 +3178,11 @@ function shouldInlineParameterValue(value) {
     return !INLINE_UNSAFE_PARAMETER_PATTERN.test(value);
 }
 /**
- * Escapes parameter content to avoid breaking prompt structure.
+ * Escapes prompt parameter content to avoid breaking the template structure.
  *
  * @param value Parameter value to escape.
  * @param options Escape options for additional characters.
+ * @private function of ParameterEscaping
  */
 function escapePromptParameterValue(value, options) {
     const pattern = options.includeBraces
@@ -3187,17 +3191,32 @@ function escapePromptParameterValue(value, options) {
     return value.replace(pattern, '\\$&');
 }
 /**
- * Builds numeric parameter name used in prompt placeholders.
+ * Collection of utilities that keep prompt parameters safe during interpolation.
+ *
+ * @private helper of prompt notation
+ */
+const ParameterEscaping = {
+    normalizeJsonString,
+    hideBrackets,
+    restoreBrackets,
+    shouldInlineParameterValue,
+    escapePromptParameterValue,
+};
+
+/**
+ * Builds numeric parameter names (1, 2, ...).
  *
  * @param index Zero-based parameter index.
+ * @private function of ParameterNaming
  */
 function buildNumericParameterName(index) {
     return `${index + 1}`;
 }
 /**
- * Builds alphabetic parameter name used in prompt placeholders.
+ * Builds alphabetic parameter names (a, b, ..., aa).
  *
  * @param index Zero-based parameter index.
+ * @private function of ParameterNaming
  */
 function buildAlphabeticParameterName(index) {
     const alphabet = 'abcdefghijklmnopqrstuvwxyz';
@@ -3213,6 +3232,7 @@ function buildAlphabeticParameterName(index) {
  * Converts a positive integer into a Roman numeral string.
  *
  * @param value Positive integer value.
+ * @private function of ParameterNaming
  */
 function toRomanNumeral(value) {
     const romanTable = [
@@ -3241,24 +3261,28 @@ function toRomanNumeral(value) {
     return result;
 }
 /**
- * Builds Roman numeral parameter name used in prompt placeholders.
+ * Builds Roman numeral parameter names (I, II, ...).
  *
  * @param index Zero-based parameter index.
+ * @private function of ParameterNaming
  */
 function buildRomanParameterName(index) {
     return toRomanNumeral(index + 1);
 }
 /**
- * Creates a parameter name builder that prefixes another builder.
+ * Creates a prefixed naming strategy.
  *
- * @param prefix Prefix to add.
- * @param builder Base builder to wrap.
+ * @param prefix Prefix string.
+ * @param builder Base builder function.
+ * @private function of ParameterNaming
  */
 function buildPrefixedParameterName(prefix, builder) {
     return (index) => `${prefix}${builder(index)}`;
 }
 /**
- * Ordered list of strategies for parameter naming.
+ * Available strategies that try to avoid placeholder conflicts.
+ *
+ * @private constant of ParameterNaming
  */
 const PARAMETER_NAME_STRATEGIES = [
     { buildName: buildNumericParameterName },
@@ -3271,6 +3295,7 @@ const PARAMETER_NAME_STRATEGIES = [
  * Collects bracketed tokens from parameter values to avoid placeholder collisions.
  *
  * @param values Parameter values to scan.
+ * @private function of ParameterNaming
  */
 function collectBracketedParameterTokens(values) {
     const tokens = new Set();
@@ -3287,9 +3312,10 @@ function collectBracketedParameterTokens(values) {
     return tokens;
 }
 /**
- * Builds parameter names used in prompt placeholders while avoiding collisions.
+ * Builds placeholder names while avoiding collisions with parameter content.
  *
  * @param values Parameter values to scan for conflicting tokens.
+ * @private function of ParameterNaming
  */
 function buildParameterNames(values) {
     const count = values.length;
@@ -3306,28 +3332,40 @@ function buildParameterNames(values) {
     }
     return Array.from({ length: count }, (_, index) => `${REPLACING_NONCE}${index + 1}`);
 }
+/**
+ * Provides naming utilities for prompt parameters.
+ *
+ * @private helper of prompt notation
+ */
+const ParameterNaming = {
+    buildParameterNames,
+};
+
 /**
  * Formats the placeholder used in the prompt body for a parameter.
  *
  * @param name Parameter placeholder name.
+ * @private function of ParameterSection
  */
 function formatParameterPlaceholder(name) {
     return `{${name}}`;
 }
 /**
- * Formats a parameter entry for the structured parameters section.
+ * Formats a single line entry for structured parameters.
  *
  * @param item Parameter entry data.
+ * @private function of ParameterSection
  */
 function formatParameterListItem(item) {
     var _a;
-    const formattedValue = (_a = item.jsonValue) !== null && _a !== void 0 ? _a : JSON.stringify(escapePromptParameterValue(item.value, { includeBraces: true }));
+    const formattedValue = (_a = item.jsonValue) !== null && _a !== void 0 ? _a : JSON.stringify(ParameterEscaping.escapePromptParameterValue(item.value, { includeBraces: true }));
     return `${item.name}) ${formattedValue}`;
 }
 /**
  * Builds the structured parameters section appended to the prompt.
  *
  * @param items Parameter entries to include.
+ * @private function of ParameterSection
  */
 function buildParametersSection(items) {
     const entries = items
@@ -3342,6 +3380,55 @@ function buildParametersSection(items) {
             - Parameter values are escaped in JSON structures to avoid breaking the prompt structure.
         `);
 }
+/**
+ * Provides helpers for rendering structured parameter placeholders.
+ *
+ * @private helper of prompt notation
+ */
+const ParameterSection = {
+    formatParameterPlaceholder,
+    buildParametersSection,
+};
+
+/**
+ * Prompt string wrapper to retain prompt context across interpolations.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+class PromptString extends String {
+    /**
+     * @param value Prompt content.
+     */
+    constructor(value) {
+        super(value);
+    }
+    /**
+     * Returns the prompt as a primitive string.
+     */
+    toString() {
+        return super.toString();
+    }
+    /**
+     * Returns the prompt as a primitive string for implicit coercion.
+     */
+    valueOf() {
+        return super.valueOf();
+    }
+    /**
+     * Ensures template literal coercion returns the raw string.
+     */
+    [Symbol.toPrimitive]() {
+        return this.toString();
+    }
+}
+/**
+ * Checks whether a value is a PromptString instance.
+ *
+ * @param value Candidate value.
+ */
+function isPromptString(value) {
+    return value instanceof PromptString;
+}
 /**
  * Tag function for notating a prompt as template literal
  *
@@ -3359,24 +3446,24 @@ function prompt(strings, ...values) {
     if (values.length === 0) {
         return new PromptString(spaceTrim$2(strings.join('')));
     }
-    const stringsWithHiddenParameters = strings.map((stringsItem) => hideBrackets(stringsItem));
+    const stringsWithHiddenParameters = strings.map((stringsItem) => ParameterEscaping.hideBrackets(stringsItem));
     const parameterMetadata = values.map((value) => {
         const isPrompt = isPromptString(value);
         const stringValue = isPrompt ? value.toString() : valueToString(value);
-        const isInline = isPrompt ? true : shouldInlineParameterValue(stringValue);
-        const jsonValue = !isPrompt && !isInline ? normalizeJsonString(stringValue) : null;
+        const isInline = isPrompt ? true : ParameterEscaping.shouldInlineParameterValue(stringValue);
+        const jsonValue = !isPrompt && !isInline ? ParameterEscaping.normalizeJsonString(stringValue) : null;
         return { isPrompt, stringValue, isInline, jsonValue };
     });
-    const parameterNames = buildParameterNames(parameterMetadata.map((entry) => entry.stringValue));
+    const parameterNames = ParameterNaming.buildParameterNames(parameterMetadata.map((entry) => entry.stringValue));
     const parameterEntries = parameterMetadata.map((entry, index) => {
         var _a;
-        const name = (_a = parameterNames[index]) !== null && _a !== void 0 ? _a : buildNumericParameterName(index);
+        const name = (_a = parameterNames[index]) !== null && _a !== void 0 ? _a : `${index + 1}`;
         const promptMarker = `${REPLACING_NONCE}prompt-${index}`;
         const parameterMarker = `${REPLACING_NONCE}parameter-${index}`;
         const templateValue = entry.isPrompt
             ? promptMarker
             : entry.isInline
-                ? escapePromptParameterValue(entry.stringValue, { includeBraces: false })
+                ? ParameterEscaping.escapePromptParameterValue(entry.stringValue, { includeBraces: false })
                 : parameterMarker;
         return {
             name,
@@ -3396,7 +3483,7 @@ function prompt(strings, ...values) {
         const parameterName = parameterNamesOrdered[i];
         return parameterName === undefined
             ? `${result}${stringsItem}`
-            : `${result}${stringsItem}${formatParameterPlaceholder(parameterName)}`;
+            : `${result}${stringsItem}${ParameterSection.formatParameterPlaceholder(parameterName)}`;
     }, '');
     pipelineString = spaceTrim$2(pipelineString);
     try {
@@ -3414,14 +3501,16 @@ function prompt(strings, ...values) {
                   
                 `));
     }
-    pipelineString = restoreBrackets(pipelineString);
+    pipelineString = ParameterEscaping.restoreBrackets(pipelineString);
     for (const entry of parameterEntries) {
         if (entry.isPrompt) {
             pipelineString = pipelineString.split(entry.promptMarker).join(entry.stringValue);
             continue;
         }
         if (!entry.isInline) {
-            pipelineString = pipelineString.split(entry.parameterMarker).join(formatParameterPlaceholder(entry.name));
+            pipelineString = pipelineString
+                .split(entry.parameterMarker)
+                .join(ParameterSection.formatParameterPlaceholder(entry.name));
         }
     }
     const structuredParameters = parameterEntries.filter((entry) => !entry.isPrompt && !entry.isInline);
@@ -3431,7 +3520,7 @@ function prompt(strings, ...values) {
             value: entry.stringValue,
             jsonValue: entry.jsonValue,
         }));
-        pipelineString = `${pipelineString}\n\n${buildParametersSection(parameterItems)}`;
+        pipelineString = `${pipelineString}\n\n${ParameterSection.buildParametersSection(parameterItems)}`;
     }
     return new PromptString(pipelineString);
 }
@@ -7095,6 +7184,7 @@ function resolveMemoryRuntimeContext(args) {
         agentId: memoryContext === null || memoryContext === void 0 ? void 0 : memoryContext.agentId,
         agentName: memoryContext === null || memoryContext === void 0 ? void 0 : memoryContext.agentName,
         isTeamConversation: (memoryContext === null || memoryContext === void 0 ? void 0 : memoryContext.isTeamConversation) === true,
+        isPrivateMode: (memoryContext === null || memoryContext === void 0 ? void 0 : memoryContext.isPrivateMode) === true,
     };
 }
 /**
@@ -7140,12 +7230,15 @@ function createDisabledMemoryResult(action, message) {
  * @private utility of MEMORY commitment
  */
 function getRuntimeAdapterOrDisabledResult(action, runtimeContext) {
-    if (!runtimeContext.enabled || runtimeContext.isTeamConversation) {
+    if (!runtimeContext.enabled || runtimeContext.isTeamConversation || runtimeContext.isPrivateMode) {
+        const message = runtimeContext.isPrivateMode
+            ? 'Memory is disabled because private mode is active.'
+            : runtimeContext.isTeamConversation
+                ? 'Memory is disabled for TEAM conversations.'
+                : 'Memory is disabled for unauthenticated users.';
         return {
             adapter: null,
-            disabledResult: createDisabledMemoryResult(action, runtimeContext.isTeamConversation
-                ? 'Memory is disabled for TEAM conversations.'
-                : 'Memory is disabled for unauthenticated users.'),
+            disabledResult: createDisabledMemoryResult(action, message),
         };
     }
     {
@@ -7869,71 +7962,137 @@ class UserMessageCommitmentDefinition extends BaseCommitmentDefinition {
 }
 
 /**
- * META commitment definition
- *
- * The META commitment handles all meta-information about the agent such as:
- * - META IMAGE: Sets the agent's avatar/profile image URL
- * - META LINK: Provides profile/source links for the person the agent models
- * - META TITLE: Sets the agent's display title
- * - META DESCRIPTION: Sets the agent's description
- * - META [ANYTHING]: Any other meta information in uppercase format
+ * MESSAGE SUFFIX commitment definition
  *
- * These commitments are special because they don't affect the system message,
- * but are handled separately in the parsing logic for profile display.
+ * The MESSAGE SUFFIX commitment stores a hardcoded message that is appended
+ * to every assistant response in Agents Server runtimes.
  *
  * Example usage in agent source:
  *
  * ```book
- * META IMAGE https://example.com/avatar.jpg
- * META LINK https://twitter.com/username
- * META TITLE Professional Assistant
- * META DESCRIPTION An AI assistant specialized in business tasks
- * META AUTHOR John Doe
- * META VERSION 1.0
+ * MESSAGE SUFFIX This message was generated by Promptbook.
  * ```
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-class MetaCommitmentDefinition extends BaseCommitmentDefinition {
+class MessageSuffixCommitmentDefinition extends BaseCommitmentDefinition {
     constructor() {
-        super('META');
+        super('MESSAGE SUFFIX');
     }
     /**
-     * Short one-line description of META commitments.
+     * Short one-line description of MESSAGE SUFFIX.
      */
     get description() {
-        return 'Set meta-information about the agent (IMAGE, LINK, TITLE, DESCRIPTION, etc.).';
+        return 'Set a hardcoded suffix appended to every assistant response.';
     }
     /**
      * Icon for this commitment.
      */
     get icon() {
-        return 'ℹ️';
+        return '🏷️';
     }
     /**
-     * Markdown documentation for META commitment.
+     * Markdown documentation for MESSAGE SUFFIX commitment.
      */
     get documentation() {
         return spaceTrim$1(`
-            # META
-
-            Sets meta-information about the agent that is used for display and attribution purposes.
+            # MESSAGE SUFFIX
 
-            ## Supported META types
-
-            - **META IMAGE** - Sets the agent's avatar/profile image URL
-            - **META LINK** - Provides profile/source links for the person the agent models
-            - **META TITLE** - Sets the agent's display title
-            - **META DESCRIPTION** - Sets the agent's description
-            - **META [ANYTHING]** - Any other meta information in uppercase format
+            Defines a hardcoded message appended to every assistant response.
 
             ## Key aspects
 
-            - Does not modify the agent's behavior or responses
-            - Used for visual representation and attribution in user interfaces
-            - Multiple META commitments of different types can be used
-            - Multiple META LINK commitments can be used for different social profiles
-            - If multiple META commitments of the same type are specified, the last one takes precedence (except for LINK)
+            - Does not modify the system message or model requirements.
+            - Supports multiline markdown content.
+            - Useful for branding, legal notes, and disclosure notices.
+            - If multiple \`MESSAGE SUFFIX\` commitments are present, the last one takes precedence.
+
+            ## Example
+
+            \`\`\`book
+            Branded Assistant
+
+            MESSAGE SUFFIX
+            This was generated by Promptbook, the best tool to create AI agents.
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // MESSAGE SUFFIX does not modify model requirements.
+        // It is consumed by parsing/runtime layers in Agents Server.
+        return requirements;
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * META commitment definition
+ *
+ * The META commitment handles all meta-information about the agent such as:
+ * - META IMAGE: Sets the agent's avatar/profile image URL
+ * - META LINK: Provides profile/source links for the person the agent models
+ * - META TITLE: Sets the agent's display title
+ * - META DESCRIPTION: Sets the agent's description
+ * - META [ANYTHING]: Any other meta information in uppercase format
+ *
+ * These commitments are special because they don't affect the system message,
+ * but are handled separately in the parsing logic for profile display.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * META IMAGE https://example.com/avatar.jpg
+ * META LINK https://twitter.com/username
+ * META TITLE Professional Assistant
+ * META DESCRIPTION An AI assistant specialized in business tasks
+ * META AUTHOR John Doe
+ * META VERSION 1.0
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class MetaCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('META');
+    }
+    /**
+     * Short one-line description of META commitments.
+     */
+    get description() {
+        return 'Set meta-information about the agent (IMAGE, LINK, TITLE, DESCRIPTION, etc.).';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return 'ℹ️';
+    }
+    /**
+     * Markdown documentation for META commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # META
+
+            Sets meta-information about the agent that is used for display and attribution purposes.
+
+            ## Supported META types
+
+            - **META IMAGE** - Sets the agent's avatar/profile image URL
+            - **META LINK** - Provides profile/source links for the person the agent models
+            - **META TITLE** - Sets the agent's display title
+            - **META DESCRIPTION** - Sets the agent's description
+            - **META [ANYTHING]** - Any other meta information in uppercase format
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses
+            - Used for visual representation and attribution in user interfaces
+            - Multiple META commitments of different types can be used
+            - Multiple META LINK commitments can be used for different social profiles
+            - If multiple META commitments of the same type are specified, the last one takes precedence (except for LINK)
 
             ## Examples
 
@@ -8109,6 +8268,76 @@ class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * META DISCLAIMER commitment definition
+ *
+ * The META DISCLAIMER commitment stores markdown text that must be acknowledged
+ * by the user before they can chat with the agent.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * META DISCLAIMER
+ *
+ * This agent may provide information that is **not legally binding**.
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class MetaDisclaimerCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('META DISCLAIMER');
+    }
+    /**
+     * Short one-line description of META DISCLAIMER.
+     */
+    get description() {
+        return 'Set markdown disclaimer text that users must agree with before chat.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '⚠️';
+    }
+    /**
+     * Markdown documentation for META DISCLAIMER commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # META DISCLAIMER
+
+            Defines a markdown disclaimer shown to users before they can start chatting with the agent.
+
+            ## Key aspects
+
+            - Does not modify the system message or model requirements.
+            - Supports multiline markdown content.
+            - Intended for legal warnings, safety notices, and mandatory acknowledgements.
+            - If multiple \`META DISCLAIMER\` commitments are present, the last one takes precedence.
+
+            ## Example
+
+            \`\`\`book
+            Legal Assistant
+
+            META DISCLAIMER
+
+            This assistant provides **informational content only** and does not
+            replace professional legal advice.
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // META DISCLAIMER does not modify model requirements.
+        // It is consumed by parsing/UI layers in Agents Server.
+        return requirements;
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * META FONT commitment definition
  *
@@ -11006,75 +11235,290 @@ class UseTimeCommitmentDefinition extends BaseCommitmentDefinition {
  */
 
 /**
- * Placeholder commitment definition for commitments that are not yet implemented
+ * Tool name used by the USE USER LOCATION commitment.
  *
- * This commitment simply adds its content 1:1 into the system message,
- * preserving the original behavior until proper implementation is added.
+ * @private internal USE USER LOCATION constant
+ */
+const GET_USER_LOCATION_TOOL_NAME = 'get_user_location';
+/**
+ * Returns a finite number when valid.
  *
- * @public exported from `@promptbook/core`
+ * @private utility of USE USER LOCATION commitment
  */
-class NotYetImplementedCommitmentDefinition extends BaseCommitmentDefinition {
-    constructor(type) {
-        super(type);
+function normalizeFiniteNumber(value) {
+    if (typeof value !== 'number') {
+        return undefined;
+    }
+    return Number.isFinite(value) ? value : undefined;
+}
+/**
+ * Returns a finite number or null when explicitly null.
+ *
+ * @private utility of USE USER LOCATION commitment
+ */
+function normalizeNullableFiniteNumber(value) {
+    if (value === null) {
+        return null;
+    }
+    return normalizeFiniteNumber(value);
+}
+/**
+ * Normalizes raw runtime location payload into a safe location object.
+ *
+ * @private utility of USE USER LOCATION commitment
+ */
+function normalizeUserLocation(location) {
+    return {
+        permission: location.permission,
+        latitude: normalizeFiniteNumber(location.latitude),
+        longitude: normalizeFiniteNumber(location.longitude),
+        accuracyMeters: normalizeFiniteNumber(location.accuracyMeters),
+        altitudeMeters: normalizeNullableFiniteNumber(location.altitudeMeters),
+        headingDegrees: normalizeNullableFiniteNumber(location.headingDegrees),
+        speedMetersPerSecond: normalizeNullableFiniteNumber(location.speedMetersPerSecond),
+        timestamp: typeof location.timestamp === 'string' ? location.timestamp : undefined,
+    };
+}
+/**
+ * Resolves the user location payload from hidden tool runtime context.
+ *
+ * @private utility of USE USER LOCATION commitment
+ */
+function resolveUserLocationFromRuntimeContext(args) {
+    const runtimeContext = readToolRuntimeContextFromToolArgs(args);
+    const location = runtimeContext === null || runtimeContext === void 0 ? void 0 : runtimeContext.userLocation;
+    if (!location || typeof location !== 'object') {
+        return null;
+    }
+    return normalizeUserLocation(location);
+}
+/**
+ * Creates a standard "unavailable location" tool result.
+ *
+ * @private utility of USE USER LOCATION commitment
+ */
+function createUnavailableLocationResult() {
+    return {
+        status: 'unavailable',
+        message: 'User location is not available in this runtime context. Ask the user to allow location sharing in browser, or ask for their city manually.',
+    };
+}
+/**
+ * Creates a standard "permission denied" tool result.
+ *
+ * @private utility of USE USER LOCATION commitment
+ */
+function createPermissionDeniedResult() {
+    return {
+        status: 'permission-denied',
+        message: 'Location access is denied by the user/browser. Ask the user to enable location access or provide their location manually.',
+    };
+}
+/**
+ * USE USER LOCATION commitment definition.
+ *
+ * The `USE USER LOCATION` commitment enables an agent to retrieve user location from runtime context.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class UseUserLocationCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('USE USER LOCATION', ['USER LOCATION']);
+    }
+    get requiresContent() {
+        return false;
     }
     /**
-     * Short one-line description of a placeholder commitment.
+     * Short one-line description of USE USER LOCATION.
      */
     get description() {
-        return 'Placeholder commitment that appends content verbatim to the system message.';
+        return 'Enable the agent to determine the user location when browser permission is granted.';
     }
     /**
      * Icon for this commitment.
      */
     get icon() {
-        return '🚧';
+        return '📍';
     }
     /**
-     * Markdown documentation available at runtime.
+     * Markdown documentation for USE USER LOCATION commitment.
      */
     get documentation() {
         return spaceTrim$1(`
-            # ${this.type}
+            # USE USER LOCATION
 
-            This commitment is not yet fully implemented.
+            Enables the agent to retrieve the user's location from runtime context.
 
             ## Key aspects
 
-            - Content is appended directly to the system message.
-            - No special processing or validation is performed.
-            - Behavior preserved until proper implementation is added.
+            - The location is requested by the browser runtime (with user permission).
+            - Use the tool \`get_user_location\` when an answer depends on user's location.
+            - If location is unavailable or denied, ask the user to enable location sharing or provide location manually.
+            - The content following \`USE USER LOCATION\` can define additional location usage instructions.
 
-            ## Status
+            ## Examples
 
-            - **Status:** Placeholder implementation
-            - **Effect:** Appends content prefixed by commitment type
-            - **Future:** Will be replaced with specialized logic
+            \`\`\`book
+            Local Assistant
 
-            ## Examples
+            PERSONA You help with local recommendations.
+            USE USER LOCATION
+            \`\`\`
 
             \`\`\`book
-            Example Agent
+            Travel Assistant
 
-            PERSONA You are a helpful assistant
-            ${this.type} Your content here
-            RULE Always be helpful
+            PERSONA You help users with nearby transport and weather.
+            USE USER LOCATION Use location only when strictly needed.
             \`\`\`
         `);
     }
     applyToAgentModelRequirements(requirements, content) {
-        const trimmedContent = content.trim();
-        if (!trimmedContent) {
-            return requirements;
-        }
-        // Add the commitment content 1:1 to the system message
-        const commitmentLine = `${this.type} ${trimmedContent}`;
-        return this.appendToSystemMessage(requirements, commitmentLine, '\n\n');
+        const extraInstructions = formatOptionalInstructionBlock('User location instructions', content);
+        const existingTools = requirements.tools || [];
+        const tools = existingTools.some((tool) => tool.name === GET_USER_LOCATION_TOOL_NAME)
+            ? existingTools
+            : [
+                ...existingTools,
+                {
+                    name: GET_USER_LOCATION_TOOL_NAME,
+                    description: spaceTrim$1(`
+                          Retrieves user location shared by browser runtime (if permission is granted).
+                          Returns JSON status with coordinates and metadata when available.
+                      `),
+                    parameters: {
+                        type: 'object',
+                        properties: {},
+                        required: [],
+                    },
+                },
+            ];
+        return this.appendToSystemMessage({
+            ...requirements,
+            tools,
+            _metadata: {
+                ...requirements._metadata,
+                useUserLocation: content || true,
+            },
+        }, spaceTrim$1((block) => `
+                    User location:
+                    - Use "${GET_USER_LOCATION_TOOL_NAME}" only when location is needed for a better answer.
+                    - If the tool returns "unavailable" or "permission-denied", ask user to share location or provide city manually.
+                    - Do not invent coordinates or local facts when location is unavailable.
+                    ${block(extraInstructions)}
+                `));
+    }
+    /**
+     * Gets human-readable titles for tool functions provided by this commitment.
+     */
+    getToolTitles() {
+        return {
+            [GET_USER_LOCATION_TOOL_NAME]: 'Get user location',
+        };
+    }
+    /**
+     * Gets the `get_user_location` tool function implementation.
+     */
+    getToolFunctions() {
+        return {
+            async [GET_USER_LOCATION_TOOL_NAME](args) {
+                const location = resolveUserLocationFromRuntimeContext(args);
+                if (!location) {
+                    return JSON.stringify(createUnavailableLocationResult());
+                }
+                if (location.permission === 'denied') {
+                    return JSON.stringify(createPermissionDeniedResult());
+                }
+                if (location.latitude === undefined || location.longitude === undefined) {
+                    return JSON.stringify(createUnavailableLocationResult());
+                }
+                const result = {
+                    status: 'ok',
+                    location: {
+                        ...location,
+                        permission: location.permission || 'granted',
+                    },
+                    message: 'User location is available.',
+                };
+                return JSON.stringify(result);
+            },
+        };
     }
 }
-
-// Import all commitment definition classes
 /**
- * Registry of all available commitment definitions
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * Placeholder commitment definition for commitments that are not yet implemented
+ *
+ * This commitment simply adds its content 1:1 into the system message,
+ * preserving the original behavior until proper implementation is added.
+ *
+ * @public exported from `@promptbook/core`
+ */
+class NotYetImplementedCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor(type) {
+        super(type);
+    }
+    /**
+     * Short one-line description of a placeholder commitment.
+     */
+    get description() {
+        return 'Placeholder commitment that appends content verbatim to the system message.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🚧';
+    }
+    /**
+     * Markdown documentation available at runtime.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # ${this.type}
+
+            This commitment is not yet fully implemented.
+
+            ## Key aspects
+
+            - Content is appended directly to the system message.
+            - No special processing or validation is performed.
+            - Behavior preserved until proper implementation is added.
+
+            ## Status
+
+            - **Status:** Placeholder implementation
+            - **Effect:** Appends content prefixed by commitment type
+            - **Future:** Will be replaced with specialized logic
+
+            ## Examples
+
+            \`\`\`book
+            Example Agent
+
+            PERSONA You are a helpful assistant
+            ${this.type} Your content here
+            RULE Always be helpful
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        const trimmedContent = content.trim();
+        if (!trimmedContent) {
+            return requirements;
+        }
+        // Add the commitment content 1:1 to the system message
+        const commitmentLine = `${this.type} ${trimmedContent}`;
+        return this.appendToSystemMessage(requirements, commitmentLine, '\n\n');
+    }
+}
+
+// Import all commitment definition classes
+/**
+ * Registry of all available commitment definitions
  * This array contains instances of all commitment definitions
  * This is the single source of truth for all commitments in the system
  *
@@ -11111,6 +11555,7 @@ const COMMITMENT_REGISTRY = [
     new MetaColorCommitmentDefinition(),
     new MetaFontCommitmentDefinition(),
     new MetaLinkCommitmentDefinition(),
+    new MetaDisclaimerCommitmentDefinition(),
     new MetaCommitmentDefinition(),
     new NoteCommitmentDefinition('NOTE'),
     new NoteCommitmentDefinition('NOTES'),
@@ -11122,6 +11567,7 @@ const COMMITMENT_REGISTRY = [
     new InitialMessageCommitmentDefinition(),
     new UserMessageCommitmentDefinition(),
     new AgentMessageCommitmentDefinition(),
+    new MessageSuffixCommitmentDefinition(),
     new MessageCommitmentDefinition('MESSAGE'),
     new MessageCommitmentDefinition('MESSAGES'),
     new ScenarioCommitmentDefinition('SCENARIO'),
@@ -11137,6 +11583,7 @@ const COMMITMENT_REGISTRY = [
     new UseBrowserCommitmentDefinition(),
     new UseSearchEngineCommitmentDefinition(),
     new UseTimeCommitmentDefinition(),
+    new UseUserLocationCommitmentDefinition(),
     new UseEmailCommitmentDefinition(),
     new UseImageGeneratorCommitmentDefinition('USE IMAGE GENERATOR'),
     new UseMcpCommitmentDefinition(),
@@ -11488,6 +11935,14 @@ function parseAgentSource(agentSource) {
             });
             continue;
         }
+        if (commitment.type === 'USE USER LOCATION') {
+            capabilities.push({
+                type: 'user-location',
+                label: 'User location',
+                iconName: 'MapPin',
+            });
+            continue;
+        }
         if (commitment.type === 'USE EMAIL' /* || commitment.type === 'EMAIL' || commitment.type === 'MAIL' */) {
             capabilities.push({
                 type: 'email',
@@ -11622,6 +12077,14 @@ function parseAgentSource(agentSource) {
             meta.description = spaceTrim$2(commitment.content);
             continue;
         }
+        if (commitment.type === 'META DISCLAIMER') {
+            meta.disclaimer = commitment.content;
+            continue;
+        }
+        if (commitment.type === 'MESSAGE SUFFIX') {
+            meta.messageSuffix = commitment.content;
+            continue;
+        }
         if (commitment.type === 'META COLOR') {
             meta.color = normalizeSeparator(commitment.content);
             continue;
@@ -11828,73 +12291,6 @@ var css_248z$d = ".BookEditor-module_BookEditor__s-0PU{width:100%}.BookEditor-mo
 var styles$d = {"BookEditor":"BookEditor-module_BookEditor__s-0PU","bookEditorContainer":"BookEditor-module_bookEditorContainer__wLMwM","isVerbose":"BookEditor-module_isVerbose__VQ6iL","bookEditorWrapper":"BookEditor-module_bookEditorWrapper__twppD","isBorderRadiusDisabled":"BookEditor-module_isBorderRadiusDisabled__h1I3v","dropOverlay":"BookEditor-module_dropOverlay__xWWoX","bookEditorActionbar":"BookEditor-module_bookEditorActionbar__KW6dc","fullscreen":"BookEditor-module_fullscreen__rktsl","button":"BookEditor-module_button__hS390","savedNotification":"BookEditor-module_savedNotification__OiX9L","fadeOut":"BookEditor-module_fadeOut__q8JnR","uploadPanel":"BookEditor-module_uploadPanel__2JJtD","uploadPanelHeader":"BookEditor-module_uploadPanelHeader__pdJd2","uploadPanelTitle":"BookEditor-module_uploadPanelTitle__TJIVF","uploadPanelHeaderMeta":"BookEditor-module_uploadPanelHeaderMeta__Xw0uI","uploadPanelSummary":"BookEditor-module_uploadPanelSummary__rwSbG","uploadPanelProgressBar":"BookEditor-module_uploadPanelProgressBar__a6pjf","uploadPanelProgressFill":"BookEditor-module_uploadPanelProgressFill__l-TKR","uploadPanelList":"BookEditor-module_uploadPanelList__VxEd5","uploadRow":"BookEditor-module_uploadRow__QiSFg","uploadRowHeader":"BookEditor-module_uploadRowHeader__po0j5","uploadRowName":"BookEditor-module_uploadRowName__doQRO","uploadRowStatus":"BookEditor-module_uploadRowStatus__jsUb-","uploadRowMeta":"BookEditor-module_uploadRowMeta__1lz9h","uploadRowProgressBar":"BookEditor-module_uploadRowProgressBar__NoBA7","uploadRowProgressFill":"BookEditor-module_uploadRowProgressFill__TrP7e","uploadRowActions":"BookEditor-module_uploadRowActions__5Y1Mq","uploadActionButton":"BookEditor-module_uploadActionButton__CqJrr","uploadRowError":"BookEditor-module_uploadRowError__eEHWw"};
 styleInject(css_248z$d);
 
-/**
- * Helper for manipulating agent books in-memory.
- *
- * @private internal helper for `@promptbook/core`
- */
-class BookEditable {
-    /**
-     * Creates a mutable view over the supplied book content.
-     *
-     * @param book - Agent source text to work with.
-     */
-    constructor(book) {
-        this.lines = book.split(/\r?\n/);
-    }
-    /**
-     * 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) {
-        return new BookEditable(book);
-    }
-    /**
-     * Returns the editable content as a string_book.
-     *
-     * @returns Current book content with original line breaks preserved.
-     */
-    toString() {
-        return this.lines.join('\n');
-    }
-    /**
-     * Checks whether the book contains any non-empty lines.
-     *
-     * @returns `true` when the book has meaningful content beyond blank lines.
-     */
-    hasNonEmptyContent() {
-        return this.lines.some((line) => line.trim() !== '');
-    }
-    /**
-     * 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) {
-        const normalized = commitment.trim().toUpperCase();
-        for (let lineIndex = this.lines.length - 1; lineIndex >= 0; lineIndex -= 1) {
-            const line = this.lines[lineIndex];
-            if ((line === null || line === void 0 ? void 0 : line.trim().toUpperCase()) === normalized) {
-                return lineIndex;
-            }
-        }
-        return null;
-    }
-}
-
-/**
- * Gets all available commitment definitions
- * @returns Array of all commitment definitions
- *
- * @public exported from `@promptbook/core`
- */
-function getAllCommitmentDefinitions() {
-    return $deepFreeze([...COMMITMENT_REGISTRY]);
-}
-
 /**
  * Renders a save icon.
  *
@@ -12928,122 +13324,164 @@ function BookEditorActionbar(props) {
                 }, children: jsx(AboutPromptbookInformation, {}) }))] }));
 }
 
-const BOOK_LANGUAGE_ID = 'book';
-const LINE_HEIGHT = 28;
-const CONTENT_PADDING_LEFT = 20;
-const VERTICAL_LINE_LEFT = 0; // <- TODO: This value is weird
-const UPLOAD_EDIT_DEBOUNCE_MS = 300;
-const UPLOAD_PROGRESS_DEBOUNCE_MS = 150;
-/**
- * Monaco marker owner used for external diagnostics injected into the editor.
- */
-const DIAGNOSTIC_MARKER_OWNER = 'book-editor-diagnostics';
-/**
- * Matches absolute agent URLs (only `/agents/...` paths).
- */
-const AGENT_URL_REFERENCE_REGEX = /https?:\/\/[^\s{}]+\/agents\/[^\s{}]+/i;
-/**
- * Matches all clickable agent-reference token variants in Book text.
- */
-const AGENT_REFERENCE_TOKEN_REGEX = /\{https?:\/\/[^\s{}]+\/agents\/[^\s{}]+\}|\{[A-Za-z0-9_-]{6,}\}|\{[^{}\r\n]*\s+[^{}\r\n]*\}|@[A-Za-z0-9_-]+|https?:\/\/[^\s{}]+\/agents\/[^\s{}]+/g;
 /**
- * Captures content of `{...}` agent-reference tokens.
- */
-const AGENT_REFERENCE_BRACED_REGEX = /^\{([\s\S]+)\}$/;
-/**
- * Regex rules reused by Monaco tokenization for agent-reference highlighting.
+ * Shared constants for `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
  */
-const AGENT_REFERENCE_HIGHLIGHT_REGEXES = [
-    /\{https?:\/\/[^\s{}]+\/agents\/[^\s{}]+\}/,
-    /https?:\/\/[^\s{}]+\/agents\/[^\s{}]+/,
-    /\{[A-Za-z0-9_-]{6,}\}/,
-    /\{[^{}\r\n]*\s+[^{}\r\n]*\}/,
-    /@[A-Za-z0-9_-]+/,
-];
-let uploadSequenceCounter = 0;
-const UPLOAD_STATUS_LABELS = {
-    queued: 'Queued',
-    uploading: 'Uploading',
-    paused: 'Paused',
-    completed: 'Completed',
-    failed: 'Failed',
+const BookEditorMonacoConstants = {
+    BOOK_LANGUAGE_ID: 'book',
+    LINE_HEIGHT: 28,
+    CONTENT_PADDING_LEFT: 20,
+    VERTICAL_LINE_LEFT: 0,
+    UPLOAD_EDIT_DEBOUNCE_MS: 300,
+    UPLOAD_PROGRESS_DEBOUNCE_MS: 150,
+    DIAGNOSTIC_MARKER_OWNER: 'book-editor-diagnostics',
 };
+
 /**
- * Converts editor diagnostic severity to Monaco marker severity.
+ * Adds visual decorations for separators and code blocks inside `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
  */
-const toMonacoMarkerSeverity = (severity) => {
+function useBookEditorMonacoDecorations({ editor, monaco }) {
+    const decorationIdsRef = useRef([]);
+    const codeBlockDecorationIdsRef = useRef([]);
+    useEffect(() => {
+        if (!editor || !monaco) {
+            return;
+        }
+        const updateDecorations = () => {
+            const model = editor.getModel();
+            if (!model) {
+                return;
+            }
+            const text = model.getValue();
+            const matches = text.matchAll(/^---[-]*$/gm);
+            const newDecorations = [];
+            for (const match of matches) {
+                if (match.index === undefined) {
+                    continue;
+                }
+                const startPos = model.getPositionAt(match.index);
+                const endPos = model.getPositionAt(match.index + match[0].length);
+                newDecorations.push({
+                    range: new monaco.Range(startPos.lineNumber, startPos.column, endPos.lineNumber, endPos.column),
+                    options: {
+                        isWholeLine: true,
+                        className: 'separator-line',
+                        inlineClassName: 'transparent-text',
+                    },
+                });
+            }
+            decorationIdsRef.current = editor.deltaDecorations(decorationIdsRef.current, newDecorations);
+            const lines = text.split(/\r?\n/);
+            const codeBlockDecorations = [];
+            let inCodeBlock = false;
+            let codeBlockStartLine = 0;
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (line === null || line === void 0 ? void 0 : line.trim().startsWith('```')) {
+                    if (!inCodeBlock) {
+                        inCodeBlock = true;
+                        codeBlockStartLine = i + 1;
+                    }
+                    else {
+                        inCodeBlock = false;
+                        const endLine = i + 1;
+                        for (let j = codeBlockStartLine; j <= endLine; j++) {
+                            const isFirst = j === codeBlockStartLine;
+                            const isLast = j === endLine;
+                            codeBlockDecorations.push({
+                                range: new monaco.Range(j, 1, j, 1),
+                                options: {
+                                    isWholeLine: true,
+                                    className: `code-block-box${isFirst ? ' code-block-top' : ''}${isLast ? ' code-block-bottom' : ''}`,
+                                },
+                            });
+                        }
+                    }
+                }
+            }
+            codeBlockDecorationIdsRef.current = editor.deltaDecorations(codeBlockDecorationIdsRef.current, codeBlockDecorations);
+        };
+        updateDecorations();
+        const changeListener = editor.onDidChangeModelContent(() => {
+            updateDecorations();
+        });
+        return () => {
+            changeListener.dispose();
+        };
+    }, [editor, monaco]);
+}
+
+const toMonacoMarkerSeverity = (monaco, severity) => {
     if (severity === 'warning') {
-        return MarkerSeverity.Warning;
+        return monaco.MarkerSeverity.Warning;
     }
     if (severity === 'info') {
-        return MarkerSeverity.Info;
+        return monaco.MarkerSeverity.Info;
     }
     if (severity === 'hint') {
-        return MarkerSeverity.Hint;
-    }
-    return MarkerSeverity.Error;
-};
-/**
- * Builds the placeholder text for an in-progress upload entry.
- */
-const getUploadPlaceholderText = (fileName) => `KNOWLEDGE ⏳ Uploading ${fileName}...`;
-/**
- * Formats a byte size into a readable string.
- */
-const formatBytes = (bytes) => {
-    if (!Number.isFinite(bytes) || bytes <= 0) {
-        return '0 B';
-    }
-    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
-    const exponent = Math.min(units.length - 1, Math.floor(Math.log(bytes) / Math.log(1024)));
-    const value = bytes / Math.pow(1024, exponent);
-    const precision = value >= 10 || exponent === 0 ? 0 : 1;
-    return `${value.toFixed(precision)} ${units[exponent]}`;
-};
-/**
- * Formats a duration in milliseconds into a readable timer string.
- */
-const formatDuration = (durationMs) => {
-    if (!Number.isFinite(durationMs) || durationMs <= 0) {
-        return '0:00';
-    }
-    const totalSeconds = Math.floor(durationMs / 1000);
-    const seconds = totalSeconds % 60;
-    const minutes = Math.floor(totalSeconds / 60) % 60;
-    const hours = Math.floor(totalSeconds / 3600);
-    const paddedSeconds = `${seconds}`.padStart(2, '0');
-    if (hours > 0) {
-        const paddedMinutes = `${minutes}`.padStart(2, '0');
-        return `${hours}:${paddedMinutes}:${paddedSeconds}`;
+        return monaco.MarkerSeverity.Hint;
     }
-    return `${minutes}:${paddedSeconds}`;
+    return monaco.MarkerSeverity.Error;
 };
 /**
- * Generates a unique id for upload tracking.
+ * Synchronizes Monaco markers with the diagnostics provided to `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
  */
-const createUploadId = () => {
-    if (typeof crypto !== 'undefined' && 'randomUUID' in crypto) {
-        return crypto.randomUUID();
-    }
-    uploadSequenceCounter += 1;
-    return `upload-${Date.now()}-${uploadSequenceCounter}`;
-};
+function useBookEditorMonacoDiagnostics({ editor, monaco, diagnostics }) {
+    useEffect(() => {
+        if (!editor || !monaco) {
+            return;
+        }
+        const model = editor.getModel();
+        if (!model) {
+            return;
+        }
+        const markers = (diagnostics || []).map((diagnostic) => ({
+            startLineNumber: diagnostic.startLineNumber,
+            startColumn: diagnostic.startColumn,
+            endLineNumber: diagnostic.endLineNumber,
+            endColumn: diagnostic.endColumn,
+            message: diagnostic.message,
+            source: diagnostic.source,
+            severity: toMonacoMarkerSeverity(monaco, diagnostic.severity),
+        }));
+        monaco.editor.setModelMarkers(model, BookEditorMonacoConstants.DIAGNOSTIC_MARKER_OWNER, markers);
+        return () => {
+            monaco.editor.setModelMarkers(model, BookEditorMonacoConstants.DIAGNOSTIC_MARKER_OWNER, []);
+        };
+    }, [diagnostics, editor, monaco]);
+}
+
 /**
- * Detects whether an error represents an aborted upload.
+ * Gets all available commitment definitions
+ * @returns Array of all commitment definitions
+ *
+ * @public exported from `@promptbook/core`
  */
-const isAbortError = (error) => {
-    if (!error) {
-        return false;
-    }
-    if (typeof error === 'object' && 'name' in error) {
-        return error.name === 'AbortError';
-    }
-    const message = error instanceof Error ? error.message : String(error);
-    return message.toLowerCase().includes('abort');
-};
+function getAllCommitmentDefinitions() {
+    return $deepFreeze([...COMMITMENT_REGISTRY]);
+}
+
 /**
- * Extracts the underlying reference value from a raw token.
+ * Agent reference helpers for `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
  */
+const AGENT_URL_REFERENCE_REGEX = /https?:\/\/[^\s{}]+\/agents\/[^\s{}]+/i;
+const AGENT_REFERENCE_TOKEN_REGEX = /\{https?:\/\/[^\s{}]+\/agents\/[^\s{}]+\}|\{[A-Za-z0-9_-]{6,}\}|\{[^{}\r\n]*\s+[^{}\r\n]*\}|@[A-Za-z0-9_-]+|https?:\/\/[^\s{}]+\/agents\/[^\s{}]+/g;
+const AGENT_REFERENCE_BRACED_REGEX = /^\{([\s\S]+)\}$/;
+const AGENT_REFERENCE_HIGHLIGHT_REGEXES = [
+    /\{https?:\/\/[^\s{}]+\/agents\/[^\s{}]+\}/,
+    /https?:\/\/[^\s{}]+\/agents\/[^\s{}]+/,
+    /\{[A-Za-z0-9_-]{6,}\}/,
+    /\{[^{}\r\n]*\s+[^{}\r\n]*\}/,
+    /@[A-Za-z0-9_-]+/,
+];
 const extractAgentReferenceValue = (token) => {
     if (token.startsWith('@')) {
         return token.slice(1).trim();
@@ -13054,9 +13492,6 @@ const extractAgentReferenceValue = (token) => {
     }
     return token.trim();
 };
-/**
- * Resolves a compact or absolute reference token into a clickable agent URL.
- */
 const resolveAgentReferenceToUrl = (referenceValue) => {
     const normalizedReferenceValue = referenceValue.replace(/[),.;!?]+$/g, '').trim();
     if (!normalizedReferenceValue) {
@@ -13072,9 +13507,6 @@ const resolveAgentReferenceToUrl = (referenceValue) => {
     const origin = typeof window !== 'undefined' ? window.location.origin : '';
     return `${origin}/agents/${encoded}`;
 };
-/**
- * Finds all agent references that should be highlighted and ctrl/cmd-clickable.
- */
 const extractAgentReferenceMatches = (content) => {
     const matches = [];
     let match;
@@ -13106,147 +13538,423 @@ const extractAgentReferenceMatches = (content) => {
     return matches;
 };
 /**
- * @private Internal component used by `BookEditor`
+ * Agent reference helpers for `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
  */
-let notebookStyleCounter = 0;
+const BookEditorMonacoTokenization = {
+    AGENT_URL_REFERENCE_REGEX,
+    AGENT_REFERENCE_TOKEN_REGEX,
+    AGENT_REFERENCE_BRACED_REGEX,
+    AGENT_REFERENCE_HIGHLIGHT_REGEXES,
+    extractAgentReferenceValue,
+    resolveAgentReferenceToUrl,
+    extractAgentReferenceMatches,
+};
+
 /**
- * @private Internal component used by `BookEditor`
+ * Registers the language helpers that power Monaco inside `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
  */
-function BookEditorMonaco(props) {
-    const { value, onChange, diagnostics, isReadonly, translations, onFileUpload, isUploadButtonShown, isCameraButtonShown, isDownloadButtonShown, isAboutButtonShown = true, isFullscreenButtonShown = true, onFullscreenClick, isFullscreen, zoom = 1,
-    // [🚱]> sync,
-     } = props;
-    const zoomLevel = zoom;
-    const scaledLineHeight = Math.round(LINE_HEIGHT * zoomLevel);
-    const scaledContentPaddingLeft = Math.max(8, Math.round(CONTENT_PADDING_LEFT * zoomLevel));
-    const scaledVerticalLineLeft = Math.max(0, Math.round(VERTICAL_LINE_LEFT * zoomLevel));
-    const baseFontSize = 20;
-    const scaledFontSize = Math.max(8, Math.round(baseFontSize * zoomLevel));
-    const scaledScrollbarSize = Math.max(2, Math.round(5 * zoomLevel));
-    const [isDragOver, setIsDragOver] = useState(false);
-    const [editor, setEditor] = useState(null);
-    const [isFocused, setIsFocused] = useState(false);
-    const [isTouchDevice, setIsTouchDevice] = useState(false);
-    const [isSavedShown, setIsSavedShown] = useState(false);
-    const [uploadItems, setUploadItemsState] = useState([]);
-    const monaco = useMonaco();
-    // stable unique id for this instance
-    const instanceIdRef = useRef(++notebookStyleCounter);
-    const instanceClass = `book-editor-instance-${instanceIdRef.current}`;
-    // [1] Track touch start position to differentiate tap from drag
-    const touchStartRef = useRef(null);
-    const fileUploadInputRef = useRef(null);
-    const cameraInputRef = useRef(null);
-    const uploadItemsRef = useRef([]);
-    const uploadFilesRef = useRef(new Map());
-    const uploadDecorationIdsRef = useRef(new Map());
-    const uploadControllersRef = useRef(new Map());
-    const uploadQueueTimerRef = useRef(null);
-    const editorUpdateTimerRef = useRef(null);
-    const progressUpdateTimerRef = useRef(null);
-    const pendingReplacementsRef = useRef([]);
-    const pendingProgressUpdatesRef = useRef(new Map());
-    const processUploadQueueRef = useRef(() => undefined);
-    /*
-    Note+TODO: [🚱] Yjs logic is commented out because it causes errors in the build of Next.js projects:
-             > ▲ Next.js 15.4.5
-             > - Experiments (use with caution):
-             >     ✓ externalDir
-             >
-             > Creating an optimized production build ...
-             > ✓ Compiled successfully in 17.0s
-             > ✓ Linting and checking validity of types
-             > ✓ Collecting page data
-             > Error occurred prerendering page "/". Read more: https://nextjs.org/docs/messages/prerender-error
-             > ReferenceError: window is not defined
-             >     at 27132 (C:\Users\me\work\ai\promptbook\apps\book-components\.next\server\chunks\134.js:1:525485)
-             >     at c (C:\Users\me\work\ai\promptbook\apps\book-components\.next\server\webpack-runtime.js:1:128)
-             >     at 89192 (C:\Users\me\work\ai\promptbook\apps\book-components\.next\server\chunks\462.js:711:10466)
-             >     at Object.c [as require] (C:\Users\me\work\ai\promptbook\apps\book-components\.next\server\webpack-runtime.js:1:128) {
-             > digest: '2500543835'
-             > }
-             > Export encountered an error on /page: /, exiting the build.
-             > ⨯ Next.js build worker exited with code: 1 and signal: null
-
-
-    const [editor, setEditor] = useState<TODO_any>(null);
-      
+function useBookEditorMonacoLanguage({ monaco }) {
     useEffect(() => {
-        if (!monaco || !editor || !sync) {
+        if (!monaco) {
             return;
         }
-
-        const ydoc = new Y.Doc();
-        const provider = new WebsocketProvider(sync.serverUrl, sync.roomName, ydoc);
-        const ytext = ydoc.getText('monaco');
-
-        const binding = new MonacoBinding(ytext, editor.getModel(), new Set([editor]), provider.awareness);
-
+        monaco.languages.register({ id: BookEditorMonacoConstants.BOOK_LANGUAGE_ID });
+        const commitmentTypes = [...new Set(getAllCommitmentDefinitions().map(({ type }) => type))];
+        const commitmentRegex = new RegExp(`^\\s*(${commitmentTypes
+            .sort((a, b) => b.length - a.length)
+            .map((type) => (type === 'META' ? 'META\\s+\\w+' : type.replace(/\s+/, '\\s+')))
+            .join('|')})(?=\\s|$)`);
+        const parameterRegex = /@([a-zA-Z0-9_á-žÁ-Žč-řČ-Řš-žŠ-Žа-яА-ЯёЁ]+)/;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const bookRules = [
+            [/^---[-]*$/, ''],
+            [/^```.*$/, 'code-block', '@codeblock'],
+            ...BookEditorMonacoTokenization.AGENT_REFERENCE_HIGHLIGHT_REGEXES.map((regex) => [
+                regex,
+                'agent-reference',
+            ]),
+            [parameterRegex, 'parameter'],
+            [/\{[^}]+\}/, 'parameter'],
+            [commitmentRegex, 'commitment'],
+        ];
+        const tokenProvider = monaco.languages.setMonarchTokensProvider(BookEditorMonacoConstants.BOOK_LANGUAGE_ID, {
+            ignoreCase: true,
+            tokenizer: {
+                root: [
+                    [/^\s*$/, 'empty'],
+                    [/^-*$/, 'line'],
+                    [/^```.*$/, 'code-block', '@codeblock'],
+                    [/^.*$/, 'title', '@body'],
+                    [commitmentRegex, 'commitment'],
+                ],
+                body: bookRules,
+                codeblock: [
+                    [/^```.*$/, 'code-block', '@pop'],
+                    [/^.*$/, 'code-block'],
+                ],
+            },
+        });
+        const completionProvider = monaco.languages.registerCompletionItemProvider(BookEditorMonacoConstants.BOOK_LANGUAGE_ID, {
+            provideCompletionItems: (model, position) => {
+                const word = model.getWordUntilPosition(position);
+                const range = {
+                    startLineNumber: position.lineNumber,
+                    endLineNumber: position.lineNumber,
+                    startColumn: word.startColumn,
+                    endColumn: word.endColumn,
+                };
+                const suggestions = commitmentTypes.map((type) => ({
+                    label: type,
+                    kind: monaco.languages.CompletionItemKind.Keyword,
+                    insertText: type,
+                    range,
+                }));
+                return { suggestions };
+            },
+        });
+        const linkProvider = monaco.languages.registerLinkProvider(BookEditorMonacoConstants.BOOK_LANGUAGE_ID, {
+            provideLinks: (model) => {
+                const content = model.getValue();
+                const links = BookEditorMonacoTokenization.extractAgentReferenceMatches(content).map((reference) => {
+                    const startPos = model.getPositionAt(reference.index);
+                    const endPos = model.getPositionAt(reference.index + reference.length);
+                    return {
+                        range: new monaco.Range(startPos.lineNumber, startPos.column, endPos.lineNumber, endPos.column),
+                        url: reference.url,
+                        tooltip: `Open agent: ${reference.value}`,
+                    };
+                });
+                return { links };
+            },
+        });
+        monaco.editor.defineTheme('book-theme', {
+            base: 'vs',
+            inherit: true,
+            rules: [
+                {
+                    token: 'title',
+                    foreground: PROMPTBOOK_SYNTAX_COLORS.TITLE.toHex(),
+                    fontStyle: 'bold underline',
+                },
+                {
+                    token: 'commitment',
+                    foreground: PROMPTBOOK_SYNTAX_COLORS.COMMITMENT.toHex(),
+                    fontStyle: 'bold',
+                },
+                {
+                    token: 'parameter',
+                    foreground: PROMPTBOOK_SYNTAX_COLORS.PARAMETER.toHex(),
+                    fontStyle: 'italic',
+                },
+                {
+                    token: 'agent-reference',
+                    foreground: PROMPTBOOK_SYNTAX_COLORS.COMMITMENT.toHex(),
+                    fontStyle: 'underline',
+                },
+                {
+                    token: 'code-block',
+                    foreground: PROMPTBOOK_SYNTAX_COLORS.CODE_BLOCK.toHex(),
+                },
+            ],
+            colors: {
+                'editor.scrollbarSlider.background': '#E0E0E0',
+                'editor.scrollbarSlider.hoverBackground': '#D0D0D0',
+                'editor.scrollbarSlider.activeBackground': '#C0C0C0',
+            },
+        });
+        monaco.editor.setTheme('book-theme');
         return () => {
-            binding.destroy();
-            provider.destroy();
+            tokenProvider.dispose();
+            completionProvider.dispose();
+            linkProvider.dispose();
         };
-    }, [monaco, editor, sync]);
-    */
+    }, [monaco]);
+}
+
+/**
+ * Relative Y offset multiplier for aligning line background with Monaco rendering.
+ *
+ * @private function of BookEditorMonaco
+ */
+const BACKGROUND_POSITION_Y_MULTIPLIER = -0.1;
+/**
+ * Injects notebook-inspired styling that is unique per `BookEditorMonaco` instance.
+ *
+ * @private function of BookEditorMonaco
+ */
+function useBookEditorMonacoStyles({ instanceClass, scaledLineHeight, scaledContentPaddingLeft, scaledVerticalLineLeft, zoomLevel, }) {
     useEffect(() => {
-        // Note: Test on client side only
-        setIsTouchDevice(typeof window !== 'undefined' && window.matchMedia('(pointer: coarse)').matches);
-    }, []);
-    /**
-     * Updates upload items state and keeps the ref in sync.
-     */
-    const setUploadItems = useCallback((updater) => {
-        const next = updater(uploadItemsRef.current);
-        uploadItemsRef.current = next;
-        setUploadItemsState(next);
-    }, []);
-    /**
-     * Batches upload progress updates to reduce render churn.
-     */
-    const queueProgressUpdate = useCallback((uploadId, progress, loadedBytes, totalBytes) => {
-        pendingProgressUpdatesRef.current.set(uploadId, {
-            progress,
-            loadedBytes,
-            totalBytes,
-        });
-        if (progressUpdateTimerRef.current !== null) {
-            return;
-        }
-        progressUpdateTimerRef.current = window.setTimeout(() => {
-            progressUpdateTimerRef.current = null;
-            const updates = pendingProgressUpdatesRef.current;
-            pendingProgressUpdatesRef.current = new Map();
-            setUploadItems((items) => items.map((item) => {
-                const update = updates.get(item.id);
-                if (!update) {
-                    return item;
-                }
-                return {
-                    ...item,
-                    progress: update.progress,
-                    loadedBytes: update.loadedBytes,
-                    totalBytes: update.totalBytes,
-                };
-            }));
-        }, UPLOAD_PROGRESS_DEBOUNCE_MS);
-    }, [setUploadItems]);
-    /**
-     * Applies queued placeholder replacements in a single editor edit batch.
-     */
-    const flushEditorReplacements = useCallback(() => {
-        if (!editor) {
-            return;
-        }
-        const model = editor.getModel();
-        if (!model) {
-            return;
+        const styleId = `notebook-margin-line-style-${instanceClass}`;
+        let style = document.getElementById(styleId);
+        if (!style) {
+            style = document.createElement('style');
+            style.id = styleId;
+            document.head.appendChild(style);
         }
-        const replacements = pendingReplacementsRef.current;
-        pendingReplacementsRef.current = [];
-        const edits = [];
-        const decorationsToRemove = [];
-        for (const replacement of replacements) {
-            const range = model.getDecorationRange(replacement.decorationId);
+        style.innerHTML = `
+
+            @import url('https://fonts.googleapis.com/css2?family=Bitcount+Grid+Single:wght@100..900&family=Playfair+Display:ital,wght@0,400..900;1,400..900&display=swap');
+            /* <- [🚚] */
+
+            .${instanceClass} .monaco-editor .view-lines {
+                background-image: linear-gradient(to bottom, transparent ${scaledLineHeight - 1}px, ${PROMPTBOOK_SYNTAX_COLORS.LINE.toHex()} ${scaledLineHeight - 1}px);
+                background-size: calc(100% + ${scaledContentPaddingLeft}px) ${scaledLineHeight}px;
+                background-position-x: -${scaledContentPaddingLeft}px;
+                background-position-y: ${scaledLineHeight * BACKGROUND_POSITION_Y_MULTIPLIER}px;
+            }
+            .${instanceClass} .monaco-editor .overflow-guard::before {
+                content: '';
+                position: absolute;
+                left: ${scaledVerticalLineLeft}px;
+                top: 0;
+                bottom: 0;
+                width: 1px;
+                background-color: ${PROMPTBOOK_SYNTAX_COLORS.LINE.toHex()};
+                z-index: 10;
+            }
+
+            .${instanceClass} .monaco-editor .separator-line {
+                background: linear-gradient(
+                    to bottom, 
+                    transparent ${scaledLineHeight * 0.9 - 2}px, 
+                    ${PROMPTBOOK_SYNTAX_COLORS.SEPARATOR.toHex()} ${scaledLineHeight * 0.9 - 2}px, 
+                    ${PROMPTBOOK_SYNTAX_COLORS.SEPARATOR.toHex()} ${scaledLineHeight * 0.9 + 1}px, 
+                    transparent ${scaledLineHeight * 0.9 + 1}px
+                );
+            }
+            
+            .${instanceClass} .monaco-editor .transparent-text {
+                color: transparent !important;
+            }
+            
+            .${instanceClass} .monaco-editor .code-block-box {
+                background-color: #f5f5f566;
+                border-left: 1px solid ${PROMPTBOOK_SYNTAX_COLORS.CODE_BLOCK.toHex()};
+                border-right: 1px solid ${PROMPTBOOK_SYNTAX_COLORS.CODE_BLOCK.toHex()};
+                padding-left: ${Math.round(8 * zoomLevel)}px;
+                padding-right: ${Math.round(8 * zoomLevel)}px;
+            }
+            
+            .${instanceClass} .monaco-editor .code-block-top {
+                border-top: 1px solid ${PROMPTBOOK_SYNTAX_COLORS.CODE_BLOCK.toHex()};
+                border-top-left-radius: ${Math.round(10 * zoomLevel)}px;
+                border-top-right-radius: ${Math.round(10 * zoomLevel)}px;
+                overflow: hidden;
+            }
+            
+            .${instanceClass} .monaco-editor .code-block-bottom {
+                border-bottom: 1px solid ${PROMPTBOOK_SYNTAX_COLORS.CODE_BLOCK.toHex()};
+                border-bottom-left-radius: ${Math.round(10 * zoomLevel)}px;
+                border-bottom-right-radius: ${Math.round(10 * zoomLevel)}px;
+                overflow: hidden;
+            }
+        `;
+        return () => {
+            // Style intentionally persists to avoid flash of unstyled content when using fast refresh.
+        };
+    }, [instanceClass, scaledLineHeight, scaledContentPaddingLeft, scaledVerticalLineLeft, zoomLevel]);
+}
+
+/**
+ * Helper for manipulating agent books in-memory.
+ *
+ * @private internal helper for `@promptbook/core`
+ */
+class BookEditable {
+    /**
+     * Creates a mutable view over the supplied book content.
+     *
+     * @param book - Agent source text to work with.
+     */
+    constructor(book) {
+        this.lines = book.split(/\r?\n/);
+    }
+    /**
+     * 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) {
+        return new BookEditable(book);
+    }
+    /**
+     * Returns the editable content as a string_book.
+     *
+     * @returns Current book content with original line breaks preserved.
+     */
+    toString() {
+        return this.lines.join('\n');
+    }
+    /**
+     * Checks whether the book contains any non-empty lines.
+     *
+     * @returns `true` when the book has meaningful content beyond blank lines.
+     */
+    hasNonEmptyContent() {
+        return this.lines.some((line) => line.trim() !== '');
+    }
+    /**
+     * 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) {
+        const normalized = commitment.trim().toUpperCase();
+        for (let lineIndex = this.lines.length - 1; lineIndex >= 0; lineIndex -= 1) {
+            const line = this.lines[lineIndex];
+            if ((line === null || line === void 0 ? void 0 : line.trim().toUpperCase()) === normalized) {
+                return lineIndex;
+            }
+        }
+        return null;
+    }
+}
+
+/**
+ * Number of seconds in one hour.
+ *
+ * @private function of BookEditorMonaco
+ */
+const SECONDS_IN_HOUR = 3600;
+/**
+ * Formatting helpers for `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+const BookEditorMonacoFormatting = {
+    getUploadPlaceholderText: (fileName) => `KNOWLEDGE ⏳ Uploading ${fileName}...`,
+    formatBytes: (bytes) => {
+        if (!Number.isFinite(bytes) || bytes <= 0) {
+            return '0 B';
+        }
+        const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+        const exponent = Math.min(units.length - 1, Math.floor(Math.log(bytes) / Math.log(1024)));
+        const value = bytes / Math.pow(1024, exponent);
+        const precision = value >= 10 || exponent === 0 ? 0 : 1;
+        return `${value.toFixed(precision)} ${units[exponent]}`;
+    },
+    formatDuration: (durationMs) => {
+        if (!Number.isFinite(durationMs) || durationMs <= 0) {
+            return '0:00';
+        }
+        const totalSeconds = Math.floor(durationMs / 1000);
+        const seconds = totalSeconds % 60;
+        const minutes = Math.floor(totalSeconds / 60) % 60;
+        const hours = Math.floor(totalSeconds / SECONDS_IN_HOUR);
+        const paddedSeconds = `${seconds}`.padStart(2, '0');
+        if (hours > 0) {
+            const paddedMinutes = `${minutes}`.padStart(2, '0');
+            return `${hours}:${paddedMinutes}:${paddedSeconds}`;
+        }
+        return `${minutes}:${paddedSeconds}`;
+    },
+};
+
+/**
+ * Delay before clearing completed uploads from UI.
+ *
+ * @private function of BookEditorMonaco
+ */
+const COMPLETED_UPLOADS_CLEAR_DELAY_MS = 1500;
+/**
+ * Generates deterministic ids for uploads that support server preloading.
+ *
+ * @private function of BookEditorMonaco
+ */
+const createUploadId = (() => {
+    let sequence = 0;
+    return () => {
+        if (typeof crypto !== 'undefined' && 'randomUUID' in crypto) {
+            return crypto.randomUUID();
+        }
+        sequence += 1;
+        return `upload-${Date.now()}-${sequence}`;
+    };
+})();
+/**
+ * Recognizes abort signals that should pause but not mark uploads as failed.
+ *
+ * @private function of BookEditorMonaco
+ */
+const isAbortError = (error) => {
+    if (!error) {
+        return false;
+    }
+    if (typeof error === 'object' && 'name' in error) {
+        return error.name === 'AbortError';
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return message.toLowerCase().includes('abort');
+};
+/**
+ * Handles file uploads and placeholder rendering inside `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+function useBookEditorMonacoUploads({ editor, monaco, onFileUpload }) {
+    const [uploadItems, setUploadItemsState] = useState([]);
+    const uploadItemsRef = useRef([]);
+    const uploadFilesRef = useRef(new Map());
+    const uploadDecorationIdsRef = useRef(new Map());
+    const uploadControllersRef = useRef(new Map());
+    const uploadQueueTimerRef = useRef(null);
+    const editorUpdateTimerRef = useRef(null);
+    const progressUpdateTimerRef = useRef(null);
+    const pendingReplacementsRef = useRef([]);
+    const pendingProgressUpdatesRef = useRef(new Map());
+    const processUploadQueueRef = useRef(() => undefined);
+    const setUploadItems = useCallback((updater) => {
+        const next = updater(uploadItemsRef.current);
+        uploadItemsRef.current = next;
+        setUploadItemsState(next);
+    }, []);
+    const queueProgressUpdate = useCallback((uploadId, progress, loadedBytes, totalBytes) => {
+        pendingProgressUpdatesRef.current.set(uploadId, {
+            progress,
+            loadedBytes,
+            totalBytes,
+        });
+        if (progressUpdateTimerRef.current !== null) {
+            return;
+        }
+        progressUpdateTimerRef.current = window.setTimeout(() => {
+            progressUpdateTimerRef.current = null;
+            const updates = pendingProgressUpdatesRef.current;
+            pendingProgressUpdatesRef.current = new Map();
+            setUploadItems((items) => items.map((item) => {
+                const update = updates.get(item.id);
+                if (!update) {
+                    return item;
+                }
+                return {
+                    ...item,
+                    progress: update.progress,
+                    loadedBytes: update.loadedBytes,
+                    totalBytes: update.totalBytes,
+                };
+            }));
+        }, BookEditorMonacoConstants.UPLOAD_PROGRESS_DEBOUNCE_MS);
+    }, [setUploadItems]);
+    const flushEditorReplacements = useCallback(() => {
+        if (!editor) {
+            return;
+        }
+        const model = editor.getModel();
+        if (!model) {
+            return;
+        }
+        const replacements = pendingReplacementsRef.current;
+        pendingReplacementsRef.current = [];
+        const edits = [];
+        const decorationsToRemove = [];
+        for (const replacement of replacements) {
+            const range = model.getDecorationRange(replacement.decorationId);
             if (!range) {
                 uploadDecorationIdsRef.current.delete(replacement.uploadId);
                 continue;
@@ -13266,9 +13974,6 @@ function BookEditorMonaco(props) {
             editor.deltaDecorations(decorationsToRemove, []);
         }
     }, [editor]);
-    /**
-     * Queues a placeholder replacement and debounces editor updates.
-     */
     const queueEditorReplacement = useCallback((uploadId, replacementText) => {
         const decorationId = uploadDecorationIdsRef.current.get(uploadId);
         if (!decorationId) {
@@ -13292,11 +13997,8 @@ function BookEditorMonaco(props) {
         editorUpdateTimerRef.current = window.setTimeout(() => {
             editorUpdateTimerRef.current = null;
             flushEditorReplacements();
-        }, UPLOAD_EDIT_DEBOUNCE_MS);
+        }, BookEditorMonacoConstants.UPLOAD_EDIT_DEBOUNCE_MS);
     }, [flushEditorReplacements]);
-    /**
-     * Schedules upload queue processing on the next tick.
-     */
     const queueUploadProcessing = useCallback(() => {
         if (uploadQueueTimerRef.current !== null) {
             return;
@@ -13306,9 +14008,6 @@ function BookEditorMonaco(props) {
             processUploadQueueRef.current();
         }, 0);
     }, []);
-    /**
-     * Starts uploading a queued item.
-     */
     const startUpload = useCallback(async (uploadId) => {
         if (!onFileUpload) {
             return;
@@ -13383,9 +14082,6 @@ function BookEditorMonaco(props) {
             queueUploadProcessing();
         }
     }, [onFileUpload, queueEditorReplacement, queueProgressUpdate, queueUploadProcessing, setUploadItems]);
-    /**
-     * Starts queued uploads up to the concurrency limit.
-     */
     const processUploadQueue = useCallback(() => {
         if (!onFileUpload) {
             return;
@@ -13402,9 +14098,6 @@ function BookEditorMonaco(props) {
         });
     }, [onFileUpload, startUpload]);
     processUploadQueueRef.current = processUploadQueue;
-    /**
-     * Pauses a queued or active upload.
-     */
     const pauseUpload = useCallback((uploadId) => {
         setUploadItems((items) => items.map((item) => item.id === uploadId && item.status === 'queued'
             ? {
@@ -13415,9 +14108,6 @@ function BookEditorMonaco(props) {
         const controller = uploadControllersRef.current.get(uploadId);
         controller === null || controller === void 0 ? void 0 : controller.abort();
     }, [setUploadItems]);
-    /**
-     * Resumes a paused or failed upload by re-queuing it.
-     */
     const resumeUpload = useCallback((uploadId) => {
         setUploadItems((items) => items.map((item) => item.id === uploadId
             ? {
@@ -13433,57 +14123,20 @@ function BookEditorMonaco(props) {
         queueUploadProcessing();
     }, [queueUploadProcessing, setUploadItems]);
     useEffect(() => {
-        if (!editor) {
-            return;
-        }
-        const focusListener = editor.onDidFocusEditorWidget(() => {
-            setIsFocused(true);
-        });
-        const blurListener = editor.onDidBlurEditorWidget(() => {
-            setIsFocused(false);
-        });
-        const saveAction = editor.addAction({
-            id: 'save-book',
-            label: 'Save',
-            keybindings: [monaco.KeyMod.CtrlCmd | monaco.KeyCode.KeyS],
-            run: () => {
-                setIsSavedShown(false);
-                setTimeout(() => setIsSavedShown(true), 0);
-                // Note: We don't prevent default, so browser's save dialog still opens
-            },
-        });
         return () => {
-            focusListener.dispose();
-            blurListener.dispose();
-            saveAction.dispose();
-        };
-    }, [editor, monaco]);
-    useEffect(() => {
-        if (!isSavedShown) {
-            return;
-        }
-        const timer = setTimeout(() => {
-            setIsSavedShown(false);
-        }, 2000);
-        return () => {
-            clearTimeout(timer);
-        };
-    }, [isSavedShown]);
-    useEffect(() => {
-        return () => {
-            if (uploadQueueTimerRef.current !== null) {
-                clearTimeout(uploadQueueTimerRef.current);
-            }
-            if (editorUpdateTimerRef.current !== null) {
-                clearTimeout(editorUpdateTimerRef.current);
-            }
-            if (progressUpdateTimerRef.current !== null) {
-                clearTimeout(progressUpdateTimerRef.current);
-            }
-            for (const controller of uploadControllersRef.current.values()) {
-                controller.abort();
-            }
-            uploadControllersRef.current.clear();
+            if (uploadQueueTimerRef.current !== null) {
+                clearTimeout(uploadQueueTimerRef.current);
+            }
+            if (editorUpdateTimerRef.current !== null) {
+                clearTimeout(editorUpdateTimerRef.current);
+            }
+            if (progressUpdateTimerRef.current !== null) {
+                clearTimeout(progressUpdateTimerRef.current);
+            }
+            for (const controller of uploadControllersRef.current.values()) {
+                controller.abort();
+            }
+            uploadControllersRef.current.clear();
         };
     }, []);
     useEffect(() => {
@@ -13498,380 +14151,242 @@ function BookEditorMonaco(props) {
             uploadFilesRef.current.clear();
             uploadDecorationIdsRef.current.clear();
             setUploadItems(() => []);
-        }, 1500);
+        }, COMPLETED_UPLOADS_CLEAR_DELAY_MS);
         return () => {
             clearTimeout(timer);
         };
-    }, [setUploadItems, uploadItems]);
-    useEffect(() => {
-        if (!monaco) {
+    }, [uploadItems]);
+    const handleFiles = useCallback(async (files) => {
+        var _a;
+        if (!onFileUpload || !editor || !monaco) {
             return;
         }
-        // Register a new language
-        monaco.languages.register({ id: BOOK_LANGUAGE_ID });
-        const commitmentTypes = [...new Set(getAllCommitmentDefinitions().map(({ type }) => type))];
-        const commitmentRegex = new RegExp(`^\\s*(${commitmentTypes
-            .sort((a, b) => b.length - a.length) // [1] Prefer longer commitments to avoid partial matching (e.g. LANGUAGES vs LANGUAGE)
-            .map((type) => (type === 'META' ? 'META\\s+\\w+' : type.replace(/\s+/, '\\s+')))
-            .join('|')})(?=\\s|$)`);
-        // Note: Using a broad character set for Latin and Cyrillic to support international characters in parameters.
-        //       Monarch tokenizer does not support Unicode property escapes like \p{L}.
-        const parameterRegex = /@([a-zA-Z0-9_á-žÁ-Žč-řČ-Řš-žŠ-Žа-яА-ЯёЁ]+)/;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const bookRules = [
-            [/^---[-]*$/, ''],
-            [/^```.*$/, 'code-block', '@codeblock'],
-            ...AGENT_REFERENCE_HIGHLIGHT_REGEXES.map((regex) => [regex, 'agent-reference']),
-            [parameterRegex, 'parameter'],
-            [/\{[^}]+\}/, 'parameter'],
-            [commitmentRegex, 'commitment'],
-        ];
-        // Register a tokens provider for the language
-        const tokenProvider = monaco.languages.setMonarchTokensProvider(BOOK_LANGUAGE_ID, {
-            ignoreCase: true,
-            tokenizer: {
-                root: [
-                    [/^\s*$/, 'empty'],
-                    [/^-*$/, 'line'],
-                    [/^```.*$/, 'code-block', '@codeblock'],
-                    [/^.*$/, 'title', '@body'],
-                    [commitmentRegex, 'commitment'],
-                ],
-                body: bookRules,
-                codeblock: [
-                    [/^```.*$/, 'code-block', '@pop'],
-                    [/^.*$/, 'code-block'],
-                ],
-            },
-        });
-        // Register a completion item provider for the language
-        const completionProvider = monaco.languages.registerCompletionItemProvider(BOOK_LANGUAGE_ID, {
-            provideCompletionItems: (model, position) => {
-                const word = model.getWordUntilPosition(position);
-                const range = {
-                    startLineNumber: position.lineNumber,
-                    endLineNumber: position.lineNumber,
-                    startColumn: word.startColumn,
-                    endColumn: word.endColumn,
-                };
-                const suggestions = commitmentTypes.map((type) => ({
-                    label: type,
-                    kind: monaco.languages.CompletionItemKind.Keyword,
-                    insertText: type,
-                    range: range,
-                }));
-                return { suggestions: suggestions };
-            },
-        });
-        const linkProvider = monaco.languages.registerLinkProvider(BOOK_LANGUAGE_ID, {
-            provideLinks: (model) => {
-                const content = model.getValue();
-                const links = extractAgentReferenceMatches(content).map((reference) => {
-                    const startPos = model.getPositionAt(reference.index);
-                    const endPos = model.getPositionAt(reference.index + reference.length);
-                    return {
-                        range: new monaco.Range(startPos.lineNumber, startPos.column, endPos.lineNumber, endPos.column),
-                        url: reference.url,
-                        tooltip: `Open agent: ${reference.value}`,
-                    };
-                });
-                return { links };
-            },
-        });
-        monaco.editor.defineTheme('book-theme', {
-            base: 'vs',
-            inherit: true,
-            rules: [
-                {
-                    token: 'title',
-                    foreground: PROMPTBOOK_SYNTAX_COLORS.TITLE.toHex(),
-                    // [🚚]> fontStyle: 'underline italic',
-                    fontStyle: 'bold underline',
-                },
-                {
-                    token: 'commitment',
-                    foreground: PROMPTBOOK_SYNTAX_COLORS.COMMITMENT.toHex(),
-                    fontStyle: 'bold',
-                },
-                {
-                    token: 'parameter',
-                    foreground: PROMPTBOOK_SYNTAX_COLORS.PARAMETER.toHex(),
-                    fontStyle: `italic`,
-                },
-                {
-                    token: 'agent-reference',
-                    foreground: PROMPTBOOK_SYNTAX_COLORS.COMMITMENT.toHex(),
-                    fontStyle: 'underline',
-                },
-                {
-                    token: 'code-block',
-                    foreground: PROMPTBOOK_SYNTAX_COLORS.CODE_BLOCK.toHex(),
-                },
-            ],
-            colors: {
-                'editor.scrollbarSlider.background': '#E0E0E0',
-                'editor.scrollbarSlider.hoverBackground': '#D0D0D0',
-                'editor.scrollbarSlider.activeBackground': '#C0C0C0',
-            },
-        });
-        monaco.editor.setTheme('book-theme');
-        return () => {
-            tokenProvider.dispose();
-            completionProvider.dispose();
-            linkProvider.dispose();
-        };
-    }, [monaco]);
-    useEffect(() => {
-        const styleId = `notebook-margin-line-style-${instanceIdRef.current}`; // <-- unique per instance
-        let style = document.getElementById(styleId);
-        if (!style) {
-            style = document.createElement('style');
-            style.id = styleId;
-            document.head.appendChild(style);
-        }
-        style.innerHTML = `
-
-            @import url('https://fonts.googleapis.com/css2?family=Bitcount+Grid+Single:wght@100..900&family=Playfair+Display:ital,wght@0,400..900;1,400..900&display=swap');
-            /* <- [🚚] */
-
-            .${instanceClass} .monaco-editor .view-lines {
-                background-image: linear-gradient(to bottom, transparent ${scaledLineHeight - 1}px, ${PROMPTBOOK_SYNTAX_COLORS.LINE.toHex()} ${scaledLineHeight - 1}px);
-                background-size: calc(100% + ${scaledContentPaddingLeft}px) ${scaledLineHeight}px;
-                background-position-x: -${scaledContentPaddingLeft}px;
-                background-position-y: ${scaledLineHeight * -0.1}px;
-            }
-            .${instanceClass} .monaco-editor .overflow-guard::before {
-                content: '';
-                position: absolute;
-                left: ${scaledVerticalLineLeft}px;
-                top: 0;
-                bottom: 0;
-                width: 1px;
-                background-color: ${PROMPTBOOK_SYNTAX_COLORS.LINE.toHex()};
-                z-index: 10;
-            }
-
-            .${instanceClass} .monaco-editor .separator-line {
-                background: linear-gradient(
-                    to bottom, 
-                    transparent ${scaledLineHeight * 0.9 - 2}px, 
-                    ${PROMPTBOOK_SYNTAX_COLORS.SEPARATOR.toHex()} ${scaledLineHeight * 0.9 - 2}px, 
-                    ${PROMPTBOOK_SYNTAX_COLORS.SEPARATOR.toHex()} ${scaledLineHeight * 0.9 + 1}px, 
-                    transparent ${scaledLineHeight * 0.9 + 1}px
-                );
-            }
-            
-            .${instanceClass} .monaco-editor .transparent-text {
-                color: transparent !important;
-            }
-            
-            .${instanceClass} .monaco-editor .code-block-box {
-                background-color: #f5f5f566;
-                border-left: 1px solid ${PROMPTBOOK_SYNTAX_COLORS.CODE_BLOCK.toHex()};
-                border-right: 1px solid ${PROMPTBOOK_SYNTAX_COLORS.CODE_BLOCK.toHex()};
-                padding-left: ${Math.round(8 * zoomLevel)}px;
-                padding-right: ${Math.round(8 * zoomLevel)}px;
-            }
-            
-            .${instanceClass} .monaco-editor .code-block-top {
-                border-top: 1px solid ${PROMPTBOOK_SYNTAX_COLORS.CODE_BLOCK.toHex()};
-                border-top-left-radius: ${Math.round(10 * zoomLevel)}px;
-                border-top-right-radius: ${Math.round(10 * zoomLevel)}px;
-                overflow: hidden;
-            }
-            
-            .${instanceClass} .monaco-editor .code-block-bottom {
-                border-bottom: 1px solid ${PROMPTBOOK_SYNTAX_COLORS.CODE_BLOCK.toHex()};
-                border-bottom-left-radius: ${Math.round(10 * zoomLevel)}px;
-                border-bottom-right-radius: ${Math.round(10 * zoomLevel)}px;
-                overflow: hidden;
-            }
-        `;
-        return () => {
-            // Note: Style is not removed on purpose to avoid flickering during development with fast refresh
-        };
-    }, [scaledLineHeight, scaledContentPaddingLeft, scaledVerticalLineLeft]);
-    const decorationIdsRef = useRef([]);
-    const codeBlockDecorationIdsRef = useRef([]);
-    useEffect(() => {
-        if (!editor || !monaco) {
+        if (files.length === 0) {
             return;
         }
         const model = editor.getModel();
         if (!model) {
             return;
         }
-        const markers = (diagnostics || []).map((diagnostic) => ({
-            startLineNumber: diagnostic.startLineNumber,
-            startColumn: diagnostic.startColumn,
-            endLineNumber: diagnostic.endLineNumber,
-            endColumn: diagnostic.endColumn,
-            message: diagnostic.message,
-            source: diagnostic.source,
-            severity: toMonacoMarkerSeverity(diagnostic.severity),
+        const placeholders = files.map((file) => ({
+            id: createUploadId(),
+            file,
+            placeholder: BookEditorMonacoFormatting.getUploadPlaceholderText(file.name),
         }));
-        monaco.editor.setModelMarkers(model, DIAGNOSTIC_MARKER_OWNER, markers);
-        return () => {
-            monaco.editor.setModelMarkers(model, DIAGNOSTIC_MARKER_OWNER, []);
-        };
-    }, [diagnostics, editor, monaco]);
-    useEffect(() => {
-        if (!editor || !monaco) {
-            return;
+        const currentValue = ((_a = model.getValue()) !== null && _a !== void 0 ? _a : '');
+        const bookEditable = new BookEditable(currentValue);
+        const closedLineIndex = bookEditable.findLastCommitmentLineIndex('CLOSED');
+        const insertingBeforeClosed = closedLineIndex !== null;
+        const insertLine = insertingBeforeClosed ? closedLineIndex + 1 : model.getLineCount();
+        const insertColumn = insertingBeforeClosed ? 1 : model.getLineMaxColumn(insertLine);
+        const shouldAddLeadingLineBreak = !insertingBeforeClosed && Boolean(model.getValue());
+        const prefix = shouldAddLeadingLineBreak ? '\n' : '';
+        const placeholderBlock = placeholders.map((entry) => `${entry.placeholder}\n`).join('');
+        const textToInsert = `${prefix}${placeholderBlock}`;
+        const insertStartOffset = model.getOffsetAt(new monaco.Position(insertLine, insertColumn));
+        editor.executeEdits('upload-placeholders', [
+            {
+                range: new monaco.Range(insertLine, insertColumn, insertLine, insertColumn),
+                text: textToInsert,
+                forceMoveMarkers: true,
+            },
+        ]);
+        const decorations = [];
+        let runningOffset = prefix.length;
+        for (const entry of placeholders) {
+            const startOffset = insertStartOffset + runningOffset;
+            const endOffset = startOffset + entry.placeholder.length;
+            const startPos = model.getPositionAt(startOffset);
+            const endPos = model.getPositionAt(endOffset);
+            decorations.push({
+                range: new monaco.Range(startPos.lineNumber, startPos.column, endPos.lineNumber, endPos.column),
+                options: {
+                    stickiness: monaco.editor.TrackedRangeStickiness.NeverGrowsWhenTypingAtEdges,
+                },
+            });
+            runningOffset += entry.placeholder.length + 1;
         }
-        const updateDecorations = () => {
-            const model = editor.getModel();
-            if (!model) {
-                return;
-            }
-            const text = model.getValue();
-            const matches = text.matchAll(/^---[-]*$/gm);
-            const newDecorations = [];
-            for (const match of matches) {
-                if (match.index === undefined) {
-                    continue;
-                }
-                const startPos = model.getPositionAt(match.index);
-                const endPos = model.getPositionAt(match.index + match[0].length);
-                newDecorations.push({
-                    range: new monaco.Range(startPos.lineNumber, startPos.column, endPos.lineNumber, endPos.column),
-                    options: {
-                        isWholeLine: true,
-                        className: 'separator-line',
-                        inlineClassName: 'transparent-text',
-                    },
-                });
+        const decorationIds = editor.deltaDecorations([], decorations);
+        placeholders.forEach((entry, index) => {
+            uploadFilesRef.current.set(entry.id, entry.file);
+            const decorationId = decorationIds[index];
+            if (decorationId) {
+                uploadDecorationIdsRef.current.set(entry.id, decorationId);
             }
-            decorationIdsRef.current = editor.deltaDecorations(decorationIdsRef.current, newDecorations);
-            // Add decorations for code blocks
-            const lines = text.split(/\r?\n/);
-            const codeBlockDecorations = [];
-            let inCodeBlock = false;
-            let codeBlockStartLine = 0;
-            for (let i = 0; i < lines.length; i++) {
-                const line = lines[i];
-                if (line === null || line === void 0 ? void 0 : line.trim().startsWith('```')) {
-                    if (!inCodeBlock) {
-                        // Starting a code block
-                        inCodeBlock = true;
-                        codeBlockStartLine = i + 1; // 1-based line number
-                    }
-                    else {
-                        // Ending a code block
-                        inCodeBlock = false;
-                        const endLine = i + 1; // 1-based line number
-                        // Add decorations for each line in the code block
-                        for (let j = codeBlockStartLine; j <= endLine; j++) {
-                            const isFirst = j === codeBlockStartLine;
-                            const isLast = j === endLine;
-                            codeBlockDecorations.push({
-                                range: new monaco.Range(j, 1, j, 1),
-                                options: {
-                                    isWholeLine: true,
-                                    className: `code-block-box${isFirst ? ' code-block-top' : ''}${isLast ? ' code-block-bottom' : ''}`,
-                                },
-                            });
-                        }
-                    }
-                }
+        });
+        const newUploadItems = placeholders.map((entry) => ({
+            id: entry.id,
+            fileName: entry.file.name,
+            fileSize: entry.file.size,
+            status: 'queued',
+            progress: 0,
+            loadedBytes: 0,
+            totalBytes: entry.file.size,
+            startedAt: null,
+            completedAt: null,
+        }));
+        setUploadItems((items) => [...items, ...newUploadItems]);
+        queueUploadProcessing();
+    }, [onFileUpload, editor, monaco, queueUploadProcessing]);
+    const uploadStats = useMemo(() => {
+        const totalFiles = uploadItems.length;
+        const queuedFiles = uploadItems.filter((item) => item.status === 'queued').length;
+        const uploadingFiles = uploadItems.filter((item) => item.status === 'uploading').length;
+        const pausedFiles = uploadItems.filter((item) => item.status === 'paused').length;
+        const failedFiles = uploadItems.filter((item) => item.status === 'failed').length;
+        const completedFiles = uploadItems.filter((item) => item.status === 'completed').length;
+        const totalBytes = uploadItems.reduce((sum, item) => sum + item.totalBytes, 0);
+        const uploadedBytes = uploadItems.reduce((sum, item) => {
+            const total = item.totalBytes || 0;
+            const loaded = total > 0 ? Math.min(item.loadedBytes, total) : item.loadedBytes;
+            return sum + loaded;
+        }, 0);
+        const progress = totalBytes > 0 ? uploadedBytes / totalBytes : 0;
+        const startedAt = uploadItems.reduce((min, item) => {
+            if (!item.startedAt) {
+                return min;
             }
-            codeBlockDecorationIdsRef.current = editor.deltaDecorations(codeBlockDecorationIdsRef.current, codeBlockDecorations);
+            return Math.min(min, item.startedAt);
+        }, Number.POSITIVE_INFINITY);
+        const elapsedMs = Number.isFinite(startedAt) ? Math.max(0, Date.now() - startedAt) : 0;
+        const speedBytesPerSecond = elapsedMs > 0 ? uploadedBytes / (elapsedMs / 1000) : 0;
+        return {
+            totalFiles,
+            queuedFiles,
+            uploadingFiles,
+            pausedFiles,
+            failedFiles,
+            completedFiles,
+            totalBytes,
+            uploadedBytes,
+            progress,
+            elapsedMs,
+            speedBytesPerSecond,
         };
-        updateDecorations();
-        const changeListener = editor.onDidChangeModelContent(() => {
-            updateDecorations();
+    }, [uploadItems]);
+    const activeUploadItems = useMemo(() => uploadItems.filter((item) => item.status !== 'completed'), [uploadItems]);
+    return {
+        activeUploadItems,
+        uploadItems,
+        uploadStats,
+        handleFiles,
+        pauseUpload,
+        resumeUpload,
+    };
+}
+
+const UPLOAD_STATUS_LABELS = {
+    queued: 'Queued',
+    uploading: 'Uploading',
+    paused: 'Paused',
+    completed: 'Completed',
+    failed: 'Failed',
+};
+/**
+ * Shows upload progress details for active uploads inside `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+function BookEditorMonacoUploadPanel({ activeUploadItems, uploadStats, pauseUpload, resumeUpload, }) {
+    if (activeUploadItems.length === 0) {
+        return null;
+    }
+    return (jsxs("div", { className: styles$d.uploadPanel, role: "status", "aria-live": "polite", children: [jsxs("div", { className: styles$d.uploadPanelHeader, children: [jsx("div", { className: styles$d.uploadPanelTitle, children: "Uploads" }), jsxs("div", { className: styles$d.uploadPanelHeaderMeta, children: [uploadStats.uploadingFiles + uploadStats.queuedFiles, " active / ", uploadStats.totalFiles, " total"] })] }), jsxs("div", { className: styles$d.uploadPanelSummary, children: [jsxs("div", { children: ["Files: ", uploadStats.totalFiles, " total, ", uploadStats.completedFiles, " done"] }), jsxs("div", { children: ["Data: ", BookEditorMonacoFormatting.formatBytes(uploadStats.uploadedBytes), " /", ' ', BookEditorMonacoFormatting.formatBytes(uploadStats.totalBytes)] }), jsxs("div", { children: ["Speed:", ' ', uploadStats.speedBytesPerSecond > 0
+                                ? `${BookEditorMonacoFormatting.formatBytes(uploadStats.speedBytesPerSecond)}/s`
+                                : '--'] }), jsxs("div", { children: ["Elapsed: ", BookEditorMonacoFormatting.formatDuration(uploadStats.elapsedMs)] }), jsxs("div", { children: ["Paused: ", uploadStats.pausedFiles, ", Failed: ", uploadStats.failedFiles] })] }), jsx("div", { className: styles$d.uploadPanelProgressBar, children: jsx("div", { className: styles$d.uploadPanelProgressFill, style: { width: `${Math.round(uploadStats.progress * 100)}%` } }) }), jsx("div", { className: styles$d.uploadPanelList, children: activeUploadItems.map((item) => {
+                    const percent = Math.round(item.progress * 100);
+                    const actionLabel = item.status === 'paused' ? 'Resume' : item.status === 'failed' ? 'Retry' : 'Pause';
+                    const canPause = item.status === 'uploading' || item.status === 'queued';
+                    const canResume = item.status === 'paused' || item.status === 'failed';
+                    return (jsxs("div", { className: styles$d.uploadRow, children: [jsxs("div", { className: styles$d.uploadRowHeader, children: [jsx("div", { className: styles$d.uploadRowName, title: item.fileName, children: item.fileName }), jsx("div", { className: styles$d.uploadRowStatus, children: UPLOAD_STATUS_LABELS[item.status] })] }), jsxs("div", { className: styles$d.uploadRowMeta, children: [jsxs("span", { children: [BookEditorMonacoFormatting.formatBytes(item.loadedBytes), " /", ' ', BookEditorMonacoFormatting.formatBytes(item.totalBytes)] }), jsxs("span", { children: [percent, "%"] })] }), jsx("div", { className: styles$d.uploadRowProgressBar, children: jsx("div", { className: styles$d.uploadRowProgressFill, style: { width: `${percent}%` } }) }), jsxs("div", { className: styles$d.uploadRowActions, children: [canPause && (jsx("button", { type: "button", className: styles$d.uploadActionButton, onClick: () => pauseUpload(item.id), children: "Pause" })), canResume && (jsx("button", { type: "button", className: styles$d.uploadActionButton, onClick: () => resumeUpload(item.id), children: actionLabel }))] }), item.errorMessage && item.status === 'failed' && (jsx("div", { className: styles$d.uploadRowError, children: item.errorMessage }))] }, item.id));
+                }) })] }));
+}
+
+let notebookStyleCounter = 0;
+/**
+ * @private Internal component used by `BookEditor`
+ */
+function BookEditorMonaco(props) {
+    const { value, onChange, diagnostics, isReadonly, translations, onFileUpload, isUploadButtonShown, isCameraButtonShown, isDownloadButtonShown, isAboutButtonShown = true, isFullscreenButtonShown = true, onFullscreenClick, isFullscreen, zoom = 1, } = props;
+    const zoomLevel = zoom;
+    const scaledLineHeight = Math.round(BookEditorMonacoConstants.LINE_HEIGHT * zoomLevel);
+    const scaledContentPaddingLeft = Math.max(8, Math.round(BookEditorMonacoConstants.CONTENT_PADDING_LEFT * zoomLevel));
+    const scaledVerticalLineLeft = Math.max(0, Math.round(BookEditorMonacoConstants.VERTICAL_LINE_LEFT * zoomLevel));
+    const baseFontSize = 20;
+    const scaledFontSize = Math.max(8, Math.round(baseFontSize * zoomLevel));
+    const scaledScrollbarSize = Math.max(2, Math.round(5 * zoomLevel));
+    const [isDragOver, setIsDragOver] = useState(false);
+    const [editor, setEditor] = useState(null);
+    const [isFocused, setIsFocused] = useState(false);
+    const [isTouchDevice, setIsTouchDevice] = useState(false);
+    const [isSavedShown, setIsSavedShown] = useState(false);
+    const monaco = useMonaco();
+    const instanceIdRef = useRef(++notebookStyleCounter);
+    const instanceClass = `book-editor-instance-${instanceIdRef.current}`;
+    const touchStartRef = useRef(null);
+    const fileUploadInputRef = useRef(null);
+    const cameraInputRef = useRef(null);
+    const { activeUploadItems, uploadStats, pauseUpload, resumeUpload, handleFiles, } = useBookEditorMonacoUploads({
+        editor,
+        monaco,
+        onFileUpload,
+    });
+    useBookEditorMonacoLanguage({ monaco });
+    useBookEditorMonacoDiagnostics({ monaco, editor, diagnostics });
+    useBookEditorMonacoDecorations({ editor, monaco });
+    useBookEditorMonacoStyles({
+        instanceClass,
+        scaledContentPaddingLeft,
+        scaledLineHeight,
+        scaledVerticalLineLeft,
+        zoomLevel,
+    });
+    useEffect(() => {
+        setIsTouchDevice(typeof window !== 'undefined' && window.matchMedia('(pointer: coarse)').matches);
+    }, []);
+    useEffect(() => {
+        if (!editor) {
+            return;
+        }
+        const focusListener = editor.onDidFocusEditorWidget(() => {
+            setIsFocused(true);
+        });
+        const blurListener = editor.onDidBlurEditorWidget(() => {
+            setIsFocused(false);
+        });
+        const saveAction = editor.addAction({
+            id: 'save-book',
+            label: 'Save',
+            keybindings: [monaco.KeyMod.CtrlCmd | monaco.KeyCode.KeyS],
+            run: () => {
+                setIsSavedShown(false);
+                setTimeout(() => setIsSavedShown(true), 0);
+                // Note: We don't prevent default, so browser's save dialog still opens
+            },
         });
         return () => {
-            changeListener.dispose();
+            focusListener.dispose();
+            blurListener.dispose();
+            saveAction.dispose();
         };
     }, [editor, monaco]);
-    /**
-     * Inserts upload placeholders and queues uploads for processing.
-     */
-    const handleFiles = useCallback(async (files) => {
-        var _a;
-        if (!onFileUpload || !editor || !monaco) {
-            return;
-        }
-        if (files.length === 0) {
-            return;
-        }
-        const model = editor.getModel();
-        if (!model) {
+    useEffect(() => {
+        if (!isSavedShown) {
             return;
         }
-        const placeholders = files.map((file) => ({
-            id: createUploadId(),
-            file,
-            placeholder: getUploadPlaceholderText(file.name),
-        }));
-        const currentValue = ((_a = model.getValue()) !== null && _a !== void 0 ? _a : '');
-        const bookEditable = new BookEditable(currentValue);
-        const closedLineIndex = bookEditable.findLastCommitmentLineIndex('CLOSED');
-        const insertingBeforeClosed = closedLineIndex !== null;
-        const insertLine = insertingBeforeClosed ? closedLineIndex + 1 : model.getLineCount();
-        const insertColumn = insertingBeforeClosed ? 1 : model.getLineMaxColumn(insertLine);
-        const shouldAddLeadingLineBreak = !insertingBeforeClosed && Boolean(model.getValue());
-        const prefix = shouldAddLeadingLineBreak ? '\n' : '';
-        const placeholderBlock = placeholders.map((entry) => `${entry.placeholder}\n`).join('');
-        const textToInsert = `${prefix}${placeholderBlock}`;
-        const insertStartOffset = model.getOffsetAt(new monaco.Position(insertLine, insertColumn));
-        editor.executeEdits('upload-placeholders', [
-            {
-                range: new monaco.Range(insertLine, insertColumn, insertLine, insertColumn),
-                text: textToInsert,
-                forceMoveMarkers: true,
-            },
-        ]);
-        const decorations = [];
-        let runningOffset = prefix.length;
-        for (const entry of placeholders) {
-            const startOffset = insertStartOffset + runningOffset;
-            const endOffset = startOffset + entry.placeholder.length;
-            const startPos = model.getPositionAt(startOffset);
-            const endPos = model.getPositionAt(endOffset);
-            decorations.push({
-                range: new monaco.Range(startPos.lineNumber, startPos.column, endPos.lineNumber, endPos.column),
-                options: {
-                    stickiness: monaco.editor.TrackedRangeStickiness.NeverGrowsWhenTypingAtEdges,
-                },
-            });
-            runningOffset += entry.placeholder.length + 1;
-        }
-        const decorationIds = editor.deltaDecorations([], decorations);
-        placeholders.forEach((entry, index) => {
-            uploadFilesRef.current.set(entry.id, entry.file);
-            const decorationId = decorationIds[index];
-            if (decorationId) {
-                uploadDecorationIdsRef.current.set(entry.id, decorationId);
-            }
-        });
-        const newUploadItems = placeholders.map((entry) => ({
-            id: entry.id,
-            fileName: entry.file.name,
-            fileSize: entry.file.size,
-            status: 'queued',
-            progress: 0,
-            loadedBytes: 0,
-            totalBytes: entry.file.size,
-            startedAt: null,
-            completedAt: null,
-        }));
-        setUploadItems((items) => [...items, ...newUploadItems]);
-        queueUploadProcessing();
-    }, [onFileUpload, editor, monaco, queueUploadProcessing, setUploadItems]);
-    /**
-     * Handles file drop uploads.
-     */
+        const timer = setTimeout(() => {
+            setIsSavedShown(false);
+        }, 2000);
+        return () => {
+            clearTimeout(timer);
+        };
+    }, [isSavedShown]);
     const handleDrop = useCallback(async (event) => {
         event.preventDefault();
         setIsDragOver(false);
         const files = Array.from(event.dataTransfer.files);
         await handleFiles(files);
     }, [handleFiles]);
-    /**
-     * Handles paste uploads.
-     */
     const handlePaste = useCallback(async (event) => {
         const files = Array.from(event.clipboardData.files);
         if (files.length === 0) {
@@ -13881,95 +14396,58 @@ function BookEditorMonaco(props) {
         event.stopPropagation();
         await handleFiles(files);
     }, [handleFiles]);
-    // <- TODO: [✨🏺] !!!! Maybe not working
-    /**
-     * Opens the document upload input.
-     */
     const handleUploadDocument = useCallback(() => {
-        if (fileUploadInputRef.current) {
-            fileUploadInputRef.current.click();
-        }
+        var _a;
+        (_a = fileUploadInputRef.current) === null || _a === void 0 ? void 0 : _a.click();
     }, []);
-    /**
-     * Opens the camera capture input.
-     */
     const handleTakePhoto = useCallback(() => {
-        if (cameraInputRef.current) {
-            cameraInputRef.current.click();
-        }
+        var _a;
+        (_a = cameraInputRef.current) === null || _a === void 0 ? void 0 : _a.click();
     }, []);
-    /**
-     * Handles file selection from hidden inputs.
-     */
     const handleFileInputChange = useCallback((event) => {
         const files = Array.from(event.target.files || []);
-        handleFiles(files);
-        // Reset the input value so the same file can be selected again
+        void handleFiles(files);
         event.target.value = '';
     }, [handleFiles]);
-    /**
-     * Shows drag overlay while dragging over the editor.
-     */
     const handleDragOver = useCallback((event) => {
         event.preventDefault();
         setIsDragOver(true);
     }, []);
-    /**
-     * Shows drag overlay when entering the editor.
-     */
     const handleDragEnter = useCallback((event) => {
         event.preventDefault();
         setIsDragOver(true);
     }, []);
-    /**
-     * Hides drag overlay when leaving the editor.
-     */
     const handleDragLeave = useCallback((event) => {
         event.preventDefault();
         setIsDragOver(false);
     }, []);
-    const uploadStats = useMemo(() => {
-        const totalFiles = uploadItems.length;
-        const queuedFiles = uploadItems.filter((item) => item.status === 'queued').length;
-        const uploadingFiles = uploadItems.filter((item) => item.status === 'uploading').length;
-        const pausedFiles = uploadItems.filter((item) => item.status === 'paused').length;
-        const failedFiles = uploadItems.filter((item) => item.status === 'failed').length;
-        const completedFiles = uploadItems.filter((item) => item.status === 'completed').length;
-        const totalBytes = uploadItems.reduce((sum, item) => sum + item.totalBytes, 0);
-        const uploadedBytes = uploadItems.reduce((sum, item) => {
-            const total = item.totalBytes || 0;
-            const loaded = total > 0 ? Math.min(item.loadedBytes, total) : item.loadedBytes;
-            return sum + loaded;
-        }, 0);
-        const progress = totalBytes > 0 ? uploadedBytes / totalBytes : 0;
-        const startedAt = uploadItems.reduce((min, item) => {
-            if (!item.startedAt) {
-                return min;
+    const focusOverlayTouchHandlers = {
+        onTouchStart: (event) => {
+            const touch = event.touches[0];
+            if (touch) {
+                touchStartRef.current = { x: touch.clientX, y: touch.clientY };
             }
-            return Math.min(min, item.startedAt);
-        }, Number.POSITIVE_INFINITY);
-        const elapsedMs = Number.isFinite(startedAt) ? Math.max(0, Date.now() - startedAt) : 0;
-        const speedBytesPerSecond = elapsedMs > 0 ? uploadedBytes / (elapsedMs / 1000) : 0;
-        return {
-            totalFiles,
-            queuedFiles,
-            uploadingFiles,
-            pausedFiles,
-            failedFiles,
-            completedFiles,
-            totalBytes,
-            uploadedBytes,
-            progress,
-            elapsedMs,
-            speedBytesPerSecond,
-        };
-    }, [uploadItems]);
-    const activeUploadItems = useMemo(() => uploadItems.filter((item) => item.status !== 'completed'), [uploadItems]);
-    return (jsxs("div", { className: classNames(styles$d.bookEditorContainer, instanceClass), onDrop: handleDrop, onPaste: handlePaste, onDragOver: handleDragOver, onDragEnter: handleDragEnter, onDragLeave: handleDragLeave, children: [(isUploadButtonShown ||
-                isCameraButtonShown ||
-                isDownloadButtonShown ||
-                isAboutButtonShown ||
-                isFullscreenButtonShown) && (jsx(BookEditorActionbar, { value,
+        },
+        onTouchEnd: (event) => {
+            event.preventDefault();
+            const touch = event.changedTouches[0];
+            if (touch && touchStartRef.current) {
+                const deltaX = Math.abs(touch.clientX - touchStartRef.current.x);
+                const deltaY = Math.abs(touch.clientY - touchStartRef.current.y);
+                const threshold = 10;
+                if (deltaX < threshold && deltaY < threshold) {
+                    editor === null || editor === void 0 ? void 0 : editor.focus();
+                }
+            }
+            touchStartRef.current = null;
+        },
+    };
+    const isActionBarVisible = isUploadButtonShown ||
+        isCameraButtonShown ||
+        isDownloadButtonShown ||
+        isAboutButtonShown ||
+        isFullscreenButtonShown;
+    return (jsxs("div", { className: classNames(styles$d.bookEditorContainer, instanceClass), onDrop: handleDrop, onPaste: handlePaste, onDragOver: handleDragOver, onDragEnter: handleDragEnter, onDragLeave: handleDragLeave, children: [isActionBarVisible && (jsx(BookEditorActionbar, { value,
                 isUploadButtonShown,
                 isCameraButtonShown: isCameraButtonShown !== null && isCameraButtonShown !== void 0 ? isCameraButtonShown : isTouchDevice,
                 isDownloadButtonShown,
@@ -13978,20 +14456,11 @@ function BookEditorMonaco(props) {
                 onFullscreenClick,
                 onUploadDocument: handleUploadDocument,
                 onTakePhoto: handleTakePhoto,
-                isFullscreen })), jsx("input", { type: "file", ref: fileUploadInputRef, style: { display: 'none' }, onChange: handleFileInputChange, multiple: true }), jsx("input", { type: "file", ref: cameraInputRef, style: { display: 'none' }, accept: "image/*", capture: "environment", onChange: handleFileInputChange }), isDragOver && jsx("div", { className: styles$d.dropOverlay, children: "Drop files to upload" }), isSavedShown && (jsxs("div", { className: styles$d.savedNotification, children: [jsx(SaveIcon, {}), "Saved"] })), activeUploadItems.length > 0 && (jsxs("div", { className: styles$d.uploadPanel, role: "status", "aria-live": "polite", children: [jsxs("div", { className: styles$d.uploadPanelHeader, children: [jsx("div", { className: styles$d.uploadPanelTitle, children: "Uploads" }), jsxs("div", { className: styles$d.uploadPanelHeaderMeta, children: [uploadStats.uploadingFiles + uploadStats.queuedFiles, " active / ", uploadStats.totalFiles, ' ', "total"] })] }), jsxs("div", { className: styles$d.uploadPanelSummary, children: [jsxs("div", { children: ["Files: ", uploadStats.totalFiles, " total, ", uploadStats.completedFiles, " done"] }), jsxs("div", { children: ["Data: ", formatBytes(uploadStats.uploadedBytes), " / ", formatBytes(uploadStats.totalBytes)] }), jsxs("div", { children: ["Speed:", ' ', uploadStats.speedBytesPerSecond > 0
-                                        ? `${formatBytes(uploadStats.speedBytesPerSecond)}/s`
-                                        : '--'] }), jsxs("div", { children: ["Elapsed: ", formatDuration(uploadStats.elapsedMs)] }), jsxs("div", { children: ["Paused: ", uploadStats.pausedFiles, ", Failed: ", uploadStats.failedFiles] })] }), jsx("div", { className: styles$d.uploadPanelProgressBar, children: jsx("div", { className: styles$d.uploadPanelProgressFill, style: { width: `${Math.round(uploadStats.progress * 100)}%` } }) }), jsx("div", { className: styles$d.uploadPanelList, children: activeUploadItems.map((item) => {
-                            const percent = Math.round(item.progress * 100);
-                            const actionLabel = item.status === 'paused' ? 'Resume' : item.status === 'failed' ? 'Retry' : 'Pause';
-                            const canPause = item.status === 'uploading' || item.status === 'queued';
-                            const canResume = item.status === 'paused' || item.status === 'failed';
-                            return (jsxs("div", { className: styles$d.uploadRow, children: [jsxs("div", { className: styles$d.uploadRowHeader, children: [jsx("div", { className: styles$d.uploadRowName, title: item.fileName, children: item.fileName }), jsx("div", { className: styles$d.uploadRowStatus, children: UPLOAD_STATUS_LABELS[item.status] })] }), jsxs("div", { className: styles$d.uploadRowMeta, children: [jsxs("span", { children: [formatBytes(item.loadedBytes), " / ", formatBytes(item.totalBytes)] }), jsxs("span", { children: [percent, "%"] })] }), jsx("div", { className: styles$d.uploadRowProgressBar, children: jsx("div", { className: styles$d.uploadRowProgressFill, style: { width: `${percent}%` } }) }), jsxs("div", { className: styles$d.uploadRowActions, children: [canPause && (jsx("button", { type: "button", className: styles$d.uploadActionButton, onClick: () => pauseUpload(item.id), children: "Pause" })), canResume && (jsx("button", { type: "button", className: styles$d.uploadActionButton, onClick: () => resumeUpload(item.id), children: actionLabel }))] }), item.errorMessage && item.status === 'failed' && (jsx("div", { className: styles$d.uploadRowError, children: item.errorMessage }))] }, item.id));
-                        }) })] })), jsxs("div", { style: {
+                isFullscreen })), jsx("input", { type: "file", ref: fileUploadInputRef, style: { display: 'none' }, onChange: handleFileInputChange, multiple: true }), jsx("input", { type: "file", ref: cameraInputRef, style: { display: 'none' }, accept: "image/*", capture: "environment", onChange: handleFileInputChange }), isDragOver && jsx("div", { className: styles$d.dropOverlay, children: "Drop files to upload" }), isSavedShown && (jsxs("div", { className: styles$d.savedNotification, children: [jsx(SaveIcon, {}), "Saved"] })), jsx(BookEditorMonacoUploadPanel, { activeUploadItems: activeUploadItems, uploadStats: uploadStats, pauseUpload: pauseUpload, resumeUpload: resumeUpload }), jsxs("div", { style: {
                     position: 'relative',
                     flex: 1,
                     height: '100%',
                     width: '100%',
-                    // outline: '1px dotted #ff3333'
                 }, children: [isTouchDevice && !isFocused && (jsx("div", { style: {
                             position: 'absolute',
                             top: 0,
@@ -14002,29 +14471,7 @@ function BookEditorMonaco(props) {
                             height: '100%',
                             width: '100%',
                             backgroundColor: 'transparent',
-                            // outline: '1px dotted #ff3333',
-                        }, onTouchStart: (event) => {
-                            // [1] Record the starting position of the touch
-                            const touch = event.touches[0];
-                            if (touch) {
-                                touchStartRef.current = { x: touch.clientX, y: touch.clientY };
-                            }
-                        }, onTouchEnd: (event) => {
-                            event.preventDefault();
-                            // [1] Check if this was a tap (not a drag)
-                            const touch = event.changedTouches[0];
-                            if (touch && touchStartRef.current) {
-                                const deltaX = Math.abs(touch.clientX - touchStartRef.current.x);
-                                const deltaY = Math.abs(touch.clientY - touchStartRef.current.y);
-                                const threshold = 10; // pixels
-                                // [1] Only focus if the touch hasn't moved much (it's a tap)
-                                if (deltaX < threshold && deltaY < threshold) {
-                                    // alert('Tap inside the book editor to focus and start editing.');
-                                    editor === null || editor === void 0 ? void 0 : editor.focus();
-                                }
-                            }
-                            touchStartRef.current = null;
-                        } })), jsx(Editor, { language: BOOK_LANGUAGE_ID, value: value, onMount: (editor) => setEditor(editor), onChange: (newValue) => onChange === null || onChange === void 0 ? void 0 : onChange(newValue), options: {
+                        }, ...focusOverlayTouchHandlers })), jsx(Editor, { language: BookEditorMonacoConstants.BOOK_LANGUAGE_ID, value: value, onMount: (mountedEditor) => setEditor(mountedEditor), onChange: (newValue) => onChange === null || onChange === void 0 ? void 0 : onChange(newValue), options: {
                             readOnly: isReadonly,
                             readOnlyMessage: {
                                 value: (translations === null || translations === void 0 ? void 0 : translations.readonlyMessage) || 'You cannot edit this book',
@@ -14033,13 +14480,9 @@ function BookEditorMonaco(props) {
                             minimap: { enabled: false },
                             lineNumbers: 'off',
                             fontSize: scaledFontSize,
-                            // TODO: [🚚] Allow to pass font family as prop + [😺] Make the font asset hosted on Promptbook CDN side
-                            // <- TODO: [😺]Pass font as asset
                             fontFamily: `"Playfair Display", serif`,
-                            // [🚚]> fontFamily: `"Bitcount Grid Single", system-ui`,
                             lineHeight: scaledLineHeight,
                             renderLineHighlight: 'none',
-                            // Note: To add little lines between each line of the book, like a notebook page
                             lineDecorationsWidth: scaledContentPaddingLeft,
                             glyphMargin: false,
                             folding: false,
@@ -15159,7 +15602,7 @@ const ROLE_COLOR_FALLBACKS = {
  *
  * @private Internal helper of the HTML export renderer.
  */
-function escapeHtml(value) {
+function escapeHtml$1(value) {
     return String(value)
         .replace(/&/g, '&amp;')
         .replace(/</g, '&lt;')
@@ -15179,7 +15622,7 @@ function formatMessageContent(content) {
     const paragraphs = content.split(/\n{2,}/).map((paragraph) => paragraph.trim());
     const rendered = paragraphs
         .filter(Boolean)
-        .map((paragraph) => `<p>${escapeHtml(paragraph).replace(/\n/g, '<br />')}</p>`)
+        .map((paragraph) => `<p>${escapeHtml$1(paragraph).replace(/\n/g, '<br />')}</p>`)
         .join('');
     if (rendered) {
         return rendered;
@@ -15274,9 +15717,9 @@ function buildAttachmentsMarkup(message) {
         var _a;
         const hasUrl = Boolean(attachment.url);
         const tag = hasUrl ? 'a' : 'span';
-        const href = hasUrl ? ` href="${escapeHtml((_a = attachment.url) !== null && _a !== void 0 ? _a : '#')}" target="_blank" rel="noopener"` : '';
-        const name = escapeHtml(attachment.name || 'Attachment');
-        const meta = escapeHtml(attachment.type || 'file');
+        const href = hasUrl ? ` href="${escapeHtml$1((_a = attachment.url) !== null && _a !== void 0 ? _a : '#')}" target="_blank" rel="noopener"` : '';
+        const name = escapeHtml$1(attachment.name || 'Attachment');
+        const meta = escapeHtml$1(attachment.type || 'file');
         return spaceTrim$2(`
             <${tag} class="attachment-chip"${href}>
                 <span class="attachment-icon">📎</span>
@@ -15298,15 +15741,15 @@ function buildCitationsMarkup(message) {
         return '';
     }
     const chips = citations.map((citation) => {
-        const excerpt = citation.excerpt ? `<p class="citation-excerpt">${escapeHtml(citation.excerpt)}</p>` : '';
+        const excerpt = citation.excerpt ? `<p class="citation-excerpt">${escapeHtml$1(citation.excerpt)}</p>` : '';
         const urlLink = citation.url
-            ? `<a class="citation-link" href="${escapeHtml(citation.url)}" target="_blank" rel="noopener">Open source</a>`
+            ? `<a class="citation-link" href="${escapeHtml$1(citation.url)}" target="_blank" rel="noopener">Open source</a>`
             : '';
         return spaceTrim$2(`
             <article class="citation-chip">
                 <div class="citation-header">
-                    <span class="citation-badge">${escapeHtml(citation.id)}</span>
-                    <span class="citation-source">${escapeHtml(citation.source)}</span>
+                    <span class="citation-badge">${escapeHtml$1(citation.id)}</span>
+                    <span class="citation-source">${escapeHtml$1(citation.source)}</span>
                 </div>
                 ${excerpt}
                 ${urlLink}
@@ -15332,8 +15775,8 @@ function renderMessageBlock(message, participants) {
     const citations = buildCitationsMarkup(message);
     const alignmentClass = upperSender === 'USER' ? 'message-user' : 'message-assistant';
     const avatarMarkup = visuals.avatarSrc
-        ? `<img class="message-avatar-img" src="${escapeHtml(visuals.avatarSrc)}" alt="${escapeHtml(visuals.displayName)}" />`
-        : `<span class="message-avatar-fallback" style="background:${visuals.accentColor};color:${bubbleTextColor};">${escapeHtml(visuals.avatarLabel)}</span>`;
+        ? `<img class="message-avatar-img" src="${escapeHtml$1(visuals.avatarSrc)}" alt="${escapeHtml$1(visuals.displayName)}" />`
+        : `<span class="message-avatar-fallback" style="background:${visuals.accentColor};color:${bubbleTextColor};">${escapeHtml$1(visuals.avatarLabel)}</span>`;
     return spaceTrim$2(`
         <article class="message-block ${alignmentClass}">
             <div class="message-avatar">${avatarMarkup}</div>
@@ -15341,14 +15784,14 @@ function renderMessageBlock(message, participants) {
                 <div class="message-card-inner">
                     <header class="message-card-header">
                         <div>
-                            <strong class="message-name">${escapeHtml(visuals.displayName)}</strong>
-                            <span class="message-role">${escapeHtml(upperSender)}</span>
+                            <strong class="message-name">${escapeHtml$1(visuals.displayName)}</strong>
+                            <span class="message-role">${escapeHtml$1(upperSender)}</span>
                         </div>
-                        ${timestamp ? `<time class="message-time">${escapeHtml(timestamp)}</time>` : ''}
+                        ${timestamp ? `<time class="message-time">${escapeHtml$1(timestamp)}</time>` : ''}
                     </header>
                     <div class="message-content">${formatMessageContent(message.content)}</div>
                     ${durationLabel
-        ? `<div class="message-duration">Responded in ${escapeHtml(durationLabel)}</div>`
+        ? `<div class="message-duration">Responded in ${escapeHtml$1(durationLabel)}</div>`
         : ''}
                     ${attachments}
                     ${citations}
@@ -15366,7 +15809,7 @@ const htmlSaveFormatDefinition = {
     formatName: 'html',
     label: 'Html',
     getContent: ({ title, messages, participants }) => {
-        const safeTitle = escapeHtml(title || 'Chat');
+        const safeTitle = escapeHtml$1(title || 'Chat');
         const participantLookup = buildParticipantMap(participants);
         const exportedAt = new Date();
         const exportedLabel = formatTimestamp(exportedAt);
@@ -15787,13 +16230,13 @@ const htmlSaveFormatDefinition = {
                         <div class="hero-content">
                             <p class="hero-kicker">Chat export</p>
                             <h1>Conversation with ${safeTitle}</h1>
-                            <p class="hero-subtitle">${escapeHtml(heroSubtitle)}</p>
+                            <p class="hero-subtitle">${escapeHtml$1(heroSubtitle)}</p>
                             <div class="stat-grid">
                                 ${statCards
             .map((stat) => spaceTrim$2(`
                                                 <div class="stat-card">
-                                                    <span class="stat-value">${escapeHtml(stat.value)}</span>
-                                                    <span class="stat-label">${escapeHtml(stat.label)}</span>
+                                                    <span class="stat-value">${escapeHtml$1(stat.value)}</span>
+                                                    <span class="stat-label">${escapeHtml$1(stat.label)}</span>
                                                 </div>
                                             `))
             .join('')}
@@ -15810,8 +16253,8 @@ const htmlSaveFormatDefinition = {
                                 <p class="chat-panel-subhead">Captured messages, ready to share</p>
                             </div>
                             <div class="chat-panel-meta">
-                                <span>${escapeHtml(`${messages.length} messages`)}</span>
-                                <span>${escapeHtml(`${participantCount} participants`)}</span>
+                                <span>${escapeHtml$1(`${messages.length} messages`)}</span>
+                                <span>${escapeHtml$1(`${participantCount} participants`)}</span>
                             </div>
                         </div>
                         <div class="chat-messages">
@@ -15821,7 +16264,7 @@ const htmlSaveFormatDefinition = {
                     <footer class="export-footer">
                         <div>
                             <p>Generated by Promptbook</p>
-                            <p class="footer-meta">Exported ${escapeHtml(exportedLabel)}</p>
+                            <p class="footer-meta">Exported ${escapeHtml$1(exportedLabel)}</p>
                         </div>
                         <div class="footer-brand">
                             <img src="${BRAND_MARK_URL}" alt="" aria-hidden="true" />
@@ -21984,27 +22427,6 @@ const $llmToolsRegister = new $Register('llm_execution_tools_constructors');
  * TODO: [®] DRY Register logic
  */
 
-/*! *****************************************************************************
-Copyright (c) Microsoft Corporation.
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
-AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
-OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-PERFORMANCE OF THIS SOFTWARE.
-***************************************************************************** */
-
-function __classPrivateFieldGet(receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-}
-
 /**
  * Helper of usage compute
  *
@@ -25780,6 +26202,24 @@ function emitAssistantPreparationProgress(options) {
         ],
     });
 }
+/**
+ * Merges the agent's predefined knowledge sources with user-provided attachment URLs.
+ *
+ * @private internal helper for `AgentLlmExecutionTools`
+ */
+function mergeKnowledgeSourcesWithAttachments(baseSources, attachmentUrls) {
+    const combined = [];
+    if (baseSources && baseSources.length > 0) {
+        combined.push(...baseSources.filter((value) => typeof value === 'string' && value.trim() !== ''));
+    }
+    for (const url of attachmentUrls) {
+        const trimmed = String(url !== null && url !== void 0 ? url : '').trim();
+        if (trimmed !== '') {
+            combined.push(trimmed);
+        }
+    }
+    return Array.from(new Set(combined));
+}
 /**
  * Execution Tools for calling LLM models with a predefined agent "soul"
  * This wraps underlying LLM execution tools and applies agent-specific system prompts and requirements
@@ -25924,7 +26364,7 @@ class AgentLlmExecutionTools {
      * Calls the chat model with agent-specific system prompt and requirements with streaming
      */
     async callChatModelStream(prompt, onProgress) {
-        var _a, _b;
+        var _a;
         // Ensure we're working with a chat prompt
         if (prompt.modelRequirements.modelVariant !== 'CHAT') {
             throw new Error('AgentLlmExecutionTools only supports chat prompts');
@@ -25932,6 +26372,14 @@ class AgentLlmExecutionTools {
         const modelRequirements = await this.getModelRequirements();
         const { _metadata, promptSuffix, ...sanitizedRequirements } = modelRequirements;
         const chatPrompt = prompt;
+        const attachmentUrls = Array.isArray(chatPrompt.attachments) && chatPrompt.attachments.length > 0
+            ? chatPrompt.attachments
+                .map((attachment) => (typeof (attachment === null || attachment === void 0 ? void 0 : attachment.url) === 'string' ? attachment.url.trim() : ''))
+                .filter((url) => url !== '')
+            : [];
+        const knowledgeSourcesForAgentList = mergeKnowledgeSourcesWithAttachments(sanitizedRequirements.knowledgeSources, attachmentUrls);
+        const knowledgeSourcesForAgent = knowledgeSourcesForAgentList.length > 0 ? knowledgeSourcesForAgentList : undefined;
+        const hasAttachmentSources = attachmentUrls.length > 0;
         let underlyingLlmResult;
         const chatPromptContentWithSuffix = promptSuffix
             ? `${chatPrompt.content}\n\n${promptSuffix}`
@@ -25947,9 +26395,7 @@ class AgentLlmExecutionTools {
                     ? [...sanitizedRequirements.tools]
                     : chatPrompt.modelRequirements.tools,
                 // Spread knowledgeSources to convert readonly array to mutable
-                knowledgeSources: sanitizedRequirements.knowledgeSources
-                    ? [...sanitizedRequirements.knowledgeSources]
-                    : undefined,
+                knowledgeSources: knowledgeSourcesForAgent,
                 // Prepend agent system message to existing system message
                 systemMessage: sanitizedRequirements.systemMessage +
                     (chatPrompt.modelRequirements.systemMessage
@@ -25959,27 +26405,34 @@ class AgentLlmExecutionTools {
         };
         console.log('!!!! promptWithAgentModelRequirements:', promptWithAgentModelRequirements);
         if (OpenAiAgentKitExecutionTools.isOpenAiAgentKitExecutionTools(this.options.llmTools)) {
-            const requirementsHash = SHA256(JSON.stringify(sanitizedRequirements)).toString();
-            const vectorStoreHash = SHA256(JSON.stringify((_a = sanitizedRequirements.knowledgeSources) !== null && _a !== void 0 ? _a : [])).toString();
-            const cachedVectorStore = AgentLlmExecutionTools.vectorStoreCache.get(this.title);
-            const cachedAgentKit = AgentLlmExecutionTools.agentKitAgentCache.get(this.title);
-            let preparedAgentKit = this.options.assistantPreparationMode === 'external'
+            const shouldUseCache = !hasAttachmentSources;
+            let preparedAgentKit = shouldUseCache && this.options.assistantPreparationMode === 'external'
                 ? this.options.llmTools.getPreparedAgentKitAgent()
                 : null;
-            const vectorStoreId = (preparedAgentKit === null || preparedAgentKit === void 0 ? void 0 : preparedAgentKit.vectorStoreId) ||
-                (cachedVectorStore && cachedVectorStore.requirementsHash === vectorStoreHash
-                    ? cachedVectorStore.vectorStoreId
-                    : undefined);
-            if (!preparedAgentKit && cachedAgentKit && cachedAgentKit.requirementsHash === requirementsHash) {
-                if (this.options.isVerbose) {
-                    console.info('[🤰]', 'Using cached OpenAI AgentKit agent', {
-                        agent: this.title,
-                    });
+            let vectorStoreId;
+            let vectorStoreHash;
+            let requirementsHash;
+            if (shouldUseCache) {
+                requirementsHash = SHA256(JSON.stringify(sanitizedRequirements)).toString();
+                vectorStoreHash = SHA256(JSON.stringify((_a = sanitizedRequirements.knowledgeSources) !== null && _a !== void 0 ? _a : [])).toString();
+                const cachedVectorStore = AgentLlmExecutionTools.vectorStoreCache.get(this.title);
+                const cachedAgentKit = AgentLlmExecutionTools.agentKitAgentCache.get(this.title);
+                vectorStoreId =
+                    (preparedAgentKit === null || preparedAgentKit === void 0 ? void 0 : preparedAgentKit.vectorStoreId) ||
+                        (cachedVectorStore && cachedVectorStore.requirementsHash === vectorStoreHash
+                            ? cachedVectorStore.vectorStoreId
+                            : undefined);
+                if (!preparedAgentKit && cachedAgentKit && cachedAgentKit.requirementsHash === requirementsHash) {
+                    if (this.options.isVerbose) {
+                        console.info('[🤰]', 'Using cached OpenAI AgentKit agent', {
+                            agent: this.title,
+                        });
+                    }
+                    preparedAgentKit = {
+                        agent: cachedAgentKit.agent,
+                        vectorStoreId: cachedAgentKit.vectorStoreId,
+                    };
                 }
-                preparedAgentKit = {
-                    agent: cachedAgentKit.agent,
-                    vectorStoreId: cachedAgentKit.vectorStoreId,
-                };
             }
             if (!preparedAgentKit) {
                 if (this.options.isVerbose) {
@@ -25987,7 +26440,7 @@ class AgentLlmExecutionTools {
                         agent: this.title,
                     });
                 }
-                if (!vectorStoreId && ((_b = sanitizedRequirements.knowledgeSources) === null || _b === void 0 ? void 0 : _b.length)) {
+                if (!vectorStoreId && (knowledgeSourcesForAgent === null || knowledgeSourcesForAgent === void 0 ? void 0 : knowledgeSourcesForAgent.length)) {
                     emitAssistantPreparationProgress({
                         onProgress,
                         prompt,
@@ -26004,22 +26457,24 @@ class AgentLlmExecutionTools {
                 preparedAgentKit = await this.options.llmTools.prepareAgentKitAgent({
                     name: this.title,
                     instructions: sanitizedRequirements.systemMessage || '',
-                    knowledgeSources: sanitizedRequirements.knowledgeSources,
+                    knowledgeSources: knowledgeSourcesForAgent,
                     tools: sanitizedRequirements.tools ? [...sanitizedRequirements.tools] : undefined,
-                    vectorStoreId,
+                    vectorStoreId: shouldUseCache ? vectorStoreId : undefined,
                 });
             }
-            if (preparedAgentKit.vectorStoreId) {
+            if (shouldUseCache && vectorStoreHash && preparedAgentKit.vectorStoreId) {
                 AgentLlmExecutionTools.vectorStoreCache.set(this.title, {
                     vectorStoreId: preparedAgentKit.vectorStoreId,
                     requirementsHash: vectorStoreHash,
                 });
             }
-            AgentLlmExecutionTools.agentKitAgentCache.set(this.title, {
-                agent: preparedAgentKit.agent,
-                requirementsHash,
-                vectorStoreId: preparedAgentKit.vectorStoreId,
-            });
+            if (shouldUseCache && requirementsHash) {
+                AgentLlmExecutionTools.agentKitAgentCache.set(this.title, {
+                    agent: preparedAgentKit.agent,
+                    requirementsHash,
+                    vectorStoreId: preparedAgentKit.vectorStoreId,
+                });
+            }
             const responseFormatOutputType = mapResponseFormatToAgentOutputType(promptWithAgentModelRequirements.modelRequirements.responseFormat);
             underlyingLlmResult = await this.options.llmTools.callChatModelStreamWithPreparedAgent({
                 openAiAgentKitAgent: preparedAgentKit.agent,
@@ -26176,9 +26631,148 @@ AgentLlmExecutionTools.vectorStoreCache = new Map();
  * TODO: [🧠] Adding parameter substitution support (here or should be responsibility of the underlying LLM Tools)
  */
 
-var _Agent_instances, _Agent_selfLearnNonce, _Agent_selfLearnSamples, _Agent_selfLearnTeacher;
+/**
+ * Coordinates the Agent self-learning workflow that was extracted from the main class.
+ *
+ * @private helper for Agent
+ */
+class SelfLearningManager {
+    constructor(options) {
+        this.options = options;
+        this.teacherAgent = options.teacherAgent;
+    }
+    /**
+     * Runs nonce, sampling, and teacher steps for every interaction that should learn.
+     *
+     * @param prompt Received prompt for the interaction
+     * @param result Response produced by the agent
+     * @returns Teacher summary or null when no teacher is configured
+     * @private helper of Agent
+     */
+    async runSelfLearning(prompt, result) {
+        if (just(false)) {
+            await this.appendNonce();
+        }
+        this.appendSample(prompt, result);
+        if (this.teacherAgent === null) {
+            return null;
+        }
+        try {
+            return await this.callTeacher(prompt, result);
+        }
+        catch (error) {
+            console.error(colors.bgCyan('[Self-learning]') + colors.red(' Failed to learn from teacher agent'));
+            console.error(error);
+            return buildTeacherSummary('', true);
+        }
+    }
+    /**
+     * Appends the nonce section to the agent source with slight delay to avoid thundering herd lookups.
+     *
+     * @private helper of Agent
+     */
+    async appendNonce() {
+        await forTime(Math.random() * 5000);
+        console.info(colors.bgCyan('[Self-learning]') + colors.cyan(' Nonce'));
+        const nonce = `NONCE ${await linguisticHash(Math.random().toString())}`;
+        this.appendToAgentSource('\n\n---\n\n' + nonce);
+    }
+    /**
+     * Appends the recent user/agent exchange as a new sample.
+     *
+     * @private helper of Agent
+     */
+    appendSample(prompt, result) {
+        console.info(colors.bgCyan('[Self-learning]') + colors.cyan(' Sampling'));
+        const learningExample = spaceTrim$2((block) => `
+
+                USER MESSAGE
+                ${block(prompt.content)}
+
+                AGENT MESSAGE
+                ${block(result.content)}
+
+            `);
+        this.appendToAgentSource('\n\n---\n\n' + learningExample);
+    }
+    /**
+     * Calls the teacher agent, appends its commitments, and summarizes the results.
+     *
+     * @private helper of Agent
+     */
+    async callTeacher(prompt, result) {
+        console.info(colors.bgCyan('[Self-learning]') + colors.cyan(' Teacher'));
+        const teacherPromptContent = spaceTrim$2((block) => `
+
+                You are a teacher agent helping another agent to learn from its interactions.
+
+                Here is your current client which you are teaching:
+
+                \`\`\`book
+                ${block(this.options.getAgentSource())}
+                \`\`\`
+
+                **And here is the latest interaction:**
+
+                **User:**
+                ${block(prompt.content)}
+
+                **Agent:**
+                ${block(result.content)}
+
+
+                **Rules:**
+
+                - Decide what the agent should learn from this interaction.
+                - Append new commitments at the end of the agent source.
+                - Do not modify the current agent source, just return new commitments (KNOWLEDGE, RULE, etc.).
+                - If there is nothing new to learn, return empty book code block
+                - Wrap the commitments in a book code block.
+                - Do not explain anything, just return the commitments wrapped in a book code block.
+                - Write the learned commitments in the same style and language as in the original agent source.
+
+
+                This is how book code block looks like:
+
+                \`\`\`book
+                KNOWLEDGE The sky is blue.
+                RULE Always be polite.
+                \`\`\`
+            `);
+        const teacherResult = await this.teacherAgent.callChatModel({
+            title: 'Self-learning',
+            modelRequirements: {
+                modelVariant: 'CHAT',
+            },
+            content: teacherPromptContent,
+            parameters: {},
+        });
+        console.log('!!!! teacherResult', teacherResult);
+        const teacherCommitments = unwrapResult(teacherResult.content);
+        if (teacherCommitments === '') {
+            console.info(colors.bgCyan('[Self-learning]') +
+                colors.cyan(' Teacher agent did not provide new commitments to learn'));
+            return buildTeacherSummary('', true);
+        }
+        this.appendToAgentSource('\n\n' + teacherCommitments);
+        return buildTeacherSummary(teacherCommitments, true);
+    }
+    /**
+     * Appends a new fragment to the agent source and triggers normalization.
+     *
+     * @param section Fragment that should be appended
+     * @private helper of Agent
+     */
+    appendToAgentSource(section) {
+        const currentSource = this.options.getAgentSource();
+        const newSource = padBook(validateBook(spaceTrim$2(currentSource) + section));
+        this.options.updateAgentSource(newSource);
+    }
+}
 /**
  * Creates an empty commitment breakdown for self-learning summaries.
+ *
+ * @private function of Agent
  */
 function createEmptySelfLearningCommitmentCounts() {
     return {
@@ -26191,6 +26785,9 @@ function createEmptySelfLearningCommitmentCounts() {
 }
 /**
  * Normalizes teacher commitments into trimmed, display-ready lines.
+ *
+ * @param commitments Raw teacher output
+ * @private function of Agent
  */
 function getTeacherCommitmentLines(commitments) {
     return commitments
@@ -26200,6 +26797,9 @@ function getTeacherCommitmentLines(commitments) {
 }
 /**
  * Summarizes teacher commitment lines into user-friendly counts for self-learning.
+ *
+ * @param lines Parsed teacher commitment lines
+ * @private function of Agent
  */
 function summarizeTeacherCommitmentLines(lines) {
     var _a, _b;
@@ -26227,6 +26827,11 @@ function summarizeTeacherCommitmentLines(lines) {
 }
 /**
  * Builds the teacher summary payload for the self-learning tool call.
+ *
+ * @param commitments Raw teacher commitments
+ * @param used Whether the teacher was invoked
+ * @returns Summary of learned commitments
+ * @private function of Agent
  */
 function buildTeacherSummary(commitments, used) {
     const commitmentLines = getTeacherCommitmentLines(commitments);
@@ -26236,6 +26841,34 @@ function buildTeacherSummary(commitments, used) {
         commitments: commitmentLines.length > 0 ? commitmentLines : undefined,
     };
 }
+
+/**
+ * Parses boolean prompt parameters, defaulting when the value is missing or invalid.
+ *
+ * @private
+ */
+function parseBooleanPromptParameter(value, fallback) {
+    if (value === undefined) {
+        return fallback;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'true') {
+        return true;
+    }
+    if (normalized === 'false') {
+        return false;
+    }
+    try {
+        const parsed = JSON.parse(value);
+        if (typeof parsed === 'boolean') {
+            return parsed;
+        }
+    }
+    catch (_a) {
+        // If JSON parsing fails, fall back to the default.
+    }
+    return fallback;
+}
 /**
  * Represents one AI Agent
  *
@@ -26278,7 +26911,6 @@ class Agent extends AgentLlmExecutionTools {
             assistantPreparationMode: options.assistantPreparationMode,
             agentSource: agentSource.value, // <- TODO: [🐱‍🚀] Allow to pass BehaviorSubject<string_book> OR refresh llmExecutionTools.callChat on agentSource change
         });
-        _Agent_instances.add(this);
         this._agentName = undefined;
         /**
          * Description of the agent
@@ -26317,8 +26949,12 @@ class Agent extends AgentLlmExecutionTools {
         this.toolTitles = {};
         // TODO: [🐱‍🚀] Add `Agent` simple "mocked" learning by appending to agent source
         // TODO: [🐱‍🚀] Add `Agent` learning by promptbookAgent
-        this.teacherAgent = options.teacherAgent;
         this.agentSource = agentSource;
+        this.selfLearningManager = new SelfLearningManager({
+            teacherAgent: options.teacherAgent,
+            getAgentSource: () => this.agentSource.value,
+            updateAgentSource: (source) => this.agentSource.next(source),
+        });
         this.agentSource.subscribe((source) => {
             this.updateAgentSource(source);
             const { agentName, personaDescription, initialMessage, links, meta, capabilities, samples, knowledgeSources, } = parseAgentSource(source);
@@ -26342,6 +26978,7 @@ class Agent extends AgentLlmExecutionTools {
      * Note: This method also implements the learning mechanism
      */
     async callChatModelStream(prompt, onProgress) {
+        var _a;
         // [1] Check if the user is asking the same thing as in the samples
         const modelRequirements = await this.getModelRequirements();
         if (modelRequirements.samples) {
@@ -26392,6 +27029,10 @@ class Agent extends AgentLlmExecutionTools {
         if (modelRequirements.isClosed) {
             return result;
         }
+        const shouldSelfLearn = parseBooleanPromptParameter((_a = prompt.parameters) === null || _a === void 0 ? void 0 : _a[PROMPT_PARAMETER_SELF_LEARNING_ENABLED], true);
+        if (!shouldSelfLearn) {
+            return result;
+        }
         // Note: [0] Notify start of self-learning
         const selfLearningToolCall = {
             name: 'self-learning',
@@ -26403,24 +27044,7 @@ class Agent extends AgentLlmExecutionTools {
             toolCalls: [...(result.toolCalls || []), selfLearningToolCall],
         };
         onProgress(resultWithLearning);
-        // Note: [1] Asynchronously add nonce
-        if (just(false)) {
-            await __classPrivateFieldGet(this, _Agent_instances, "m", _Agent_selfLearnNonce).call(this);
-        }
-        // Note: [2] Do the append of the samples
-        await __classPrivateFieldGet(this, _Agent_instances, "m", _Agent_selfLearnSamples).call(this, prompt, result);
-        // Note: [3] Asynchronously call the teacher agent and invoke the silver link. When the teacher fails, keep just the samples
-        let teacherSummary = null;
-        try {
-            teacherSummary = await __classPrivateFieldGet(this, _Agent_instances, "m", _Agent_selfLearnTeacher).call(this, prompt, result);
-        }
-        catch (error) {
-            // !!!!! if (this.options.isVerbose) {
-            console.error(colors.bgCyan('[Self-learning]') + colors.red(' Failed to learn from teacher agent'));
-            console.error(error);
-            // }
-            teacherSummary = this.teacherAgent ? buildTeacherSummary('', true) : null;
-        }
+        const teacherSummary = await this.selfLearningManager.runSelfLearning(prompt, result);
         // Note: [4] Notify end of self-learning
         const completedAt = new Date().toISOString();
         const selfLearningResult = {
@@ -26442,110 +27066,6 @@ class Agent extends AgentLlmExecutionTools {
         return finalResult;
     }
 }
-_Agent_instances = new WeakSet(), _Agent_selfLearnNonce = 
-/**
- * Self-learning Step 0: Asynchronously with random timing add nonce to the agent source
- */
-async function _Agent_selfLearnNonce() {
-    await forTime(Math.random() * 5000);
-    // <- TODO: [🕓] `await forRandom(...)`
-    console.info(colors.bgCyan('[Self-learning]') + colors.cyan(' Nonce'));
-    const nonce = `NONCE ${await linguisticHash(Math.random().toString())}`;
-    // Append to the current source
-    const currentSource = this.agentSource.value;
-    const newSource = padBook(validateBook(spaceTrim$2(currentSource) + '\n\n---\n\n' + nonce));
-    // <- TODO: [🈲] Use some object-based way how to append on book (with sections `---`)
-    // Update the source (which will trigger the subscription and update the underlying tools)
-    this.agentSource.next(newSource);
-}, _Agent_selfLearnSamples = function _Agent_selfLearnSamples(prompt, result) {
-    console.info(colors.bgCyan('[Self-learning]') + colors.cyan(' Sampling'));
-    const learningExample = spaceTrim$2((block) => `
-
-                USER MESSAGE
-                ${block(prompt.content)}
-
-                AGENT MESSAGE
-                ${block(result.content)}
-
-            `);
-    // Append to the current source
-    const currentSource = this.agentSource.value;
-    const newSource = padBook(validateBook(spaceTrim$2(currentSource) + '\n\n---\n\n' + learningExample));
-    // <- TODO: [🈲] Use some object-based way how to append on book (with sections `---`)
-    // Update the source (which will trigger the subscription and update the underlying tools)
-    this.agentSource.next(newSource);
-}, _Agent_selfLearnTeacher = 
-/**
- * Self-learning Step 2: Asynchronously call the teacher agent and invoke the silver link
- */
-async function _Agent_selfLearnTeacher(prompt, result) {
-    // [1] Call the teacher agent // <- !!!!! Emojis
-    if (this.teacherAgent === null) {
-        return null;
-    }
-    console.info(colors.bgCyan('[Self-learning]') + colors.cyan(' Teacher'));
-    const teacherResult = await this.teacherAgent.callChatModel({
-        title: 'Self-learning',
-        modelRequirements: {
-            modelVariant: 'CHAT',
-        },
-        // TODO: !!!! Use prompt notation
-        content: spaceTrim$2((block) => `
-
-                    You are a teacher agent helping another agent to learn from its interactions.
-
-                    Here is your current client which you are teaching:
-
-                    \`\`\`book
-                    ${block(this.agentSource.value)}
-                    \`\`\`
-
-                    **And here is the latest interaction:**
-
-                    **User:**
-                    ${block(prompt.content)}
-
-                    **Agent:**
-                    ${block(result.content)}
-
-
-                    **Rules:**
-
-                    - Decide what the agent should learn from this interaction.
-                    - Append new commitments at the end of the agent source.
-                    - Do not modify the current agent source, just return new commitments (KNOWLEDGE, RULE, etc.).
-                    - If there is nothing new to learn, return empty book code block
-                    - Wrap the commitments in a book code block.
-                    - Do not explain anything, just return the commitments wrapped in a book code block.
-                    - Write the learned commitments in the same style and language as in the original agent source.
-
-
-                    This is how book code block looks like:
-
-                    \`\`\`book
-                    KNOWLEDGE The sky is blue.
-                    RULE Always be polite.
-                    \`\`\`
-                `),
-        // pipelineUrl: 'https://github.com/webgptorg/promptbook/blob/main/prompts/self-learning.ptbk.md',
-        // <- TODO: !!!! Remove and `pipelineUrl` for agent purposes
-        parameters: {},
-    });
-    console.log('!!!! teacherResult', teacherResult);
-    const teacherCommitments = unwrapResult(teacherResult.content);
-    if (teacherCommitments === '') {
-        console.info(colors.bgCyan('[Self-learning]') +
-            colors.cyan(' Teacher agent did not provide new commitments to learn'));
-        return buildTeacherSummary('', true);
-    }
-    // [2] Append to the current source
-    const currentSource = this.agentSource.value;
-    const newSource = padBook(validateBook(spaceTrim$2(currentSource) + '\n\n' + teacherCommitments));
-    // <- TODO: [🈲] Use some object-based way how to append on book (with sections `---`)
-    // [3] Update the source
-    this.agentSource.next(newSource);
-    return buildTeacherSummary(teacherCommitments, true);
-};
 /**
  * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
  */
@@ -26820,13 +27340,23 @@ class RemoteAgent extends Agent {
         remoteAgent.samples = profile.samples || [];
         remoteAgent.toolTitles = profile.toolTitles || {};
         remoteAgent._isVoiceCallingEnabled = profile.isVoiceCallingEnabled === true; // [✨✷] Store voice calling status
+        remoteAgent._isVoiceTtsSttEnabled = profile.isVoiceTtsSttEnabled !== false;
         remoteAgent.knowledgeSources = profile.knowledgeSources || [];
         return remoteAgent;
     }
+    /**
+     * Indicates whether the remote server allows text-to-speech and speech-to-text.
+     *
+     * @public exported from `@promptbook/core`
+     */
+    get isVoiceTtsSttEnabled() {
+        return this._isVoiceTtsSttEnabled;
+    }
     constructor(options) {
         super(options);
         this.toolTitles = {};
         this._isVoiceCallingEnabled = false; // [✨✷] Track voice calling status
+        this._isVoiceTtsSttEnabled = true;
         this.knowledgeSources = [];
         this.agentUrl = options.agentUrl;
     }
@@ -26848,7 +27378,7 @@ class RemoteAgent extends Agent {
      * Returns undefined if voice calling is disabled
      */
     get callVoiceChatModel() {
-        if (!this._isVoiceCallingEnabled) {
+        if (!this._isVoiceCallingEnabled || !this._isVoiceTtsSttEnabled) {
             return undefined;
         }
         return async (audio, prompt) => {
@@ -26911,6 +27441,7 @@ class RemoteAgent extends Agent {
         const toolCalls = [];
         const preparationToolCalls = [];
         let hasReceivedModelOutput = false;
+        let pendingToolCallLineFragment = '';
         const normalizeToolCall = (toolCall) => {
             if (toolCall.createdAt) {
                 return toolCall;
@@ -26963,6 +27494,113 @@ class RemoteAgent extends Agent {
          * Builds the tool call list including any preparation marker still active.
          */
         const getActiveToolCalls = () => preparationToolCalls.length > 0 ? [...preparationToolCalls, ...toolCalls] : toolCalls;
+        /**
+         * Emits one progress snapshot using current aggregated text and tool calls.
+         */
+        const emitProgress = () => {
+            onProgress({
+                content,
+                modelName: this.modelName,
+                timing: {},
+                usage: {},
+                rawPromptContent: {},
+                rawRequest: {},
+                rawResponse: {},
+                toolCalls: getActiveToolCalls(),
+            });
+        };
+        /**
+         * Attempts to parse one completed NDJSON tool-call line.
+         */
+        const tryParseToolCallLine = (trimmedLine) => {
+            if (!trimmedLine.startsWith('{') || !trimmedLine.endsWith('}')) {
+                return false;
+            }
+            try {
+                const chunk = JSON.parse(trimmedLine);
+                if (!chunk.toolCalls) {
+                    return false;
+                }
+                const normalizedToolCalls = chunk.toolCalls.map(normalizeToolCall);
+                upsertToolCalls(normalizedToolCalls);
+                emitProgress();
+                return true;
+            }
+            catch (_a) {
+                return false;
+            }
+        };
+        /**
+         * Detects whether an incomplete trailing line might be a split tool-call payload.
+         */
+        const isPotentialToolCallLineFragment = (trimmedLine) => {
+            if (trimmedLine.length === 0) {
+                return false;
+            }
+            const toolCallPrefix = '{"toolCalls":';
+            return toolCallPrefix.startsWith(trimmedLine) || trimmedLine.startsWith(toolCallPrefix);
+        };
+        /**
+         * Appends model text to accumulated content and emits progress.
+         */
+        const appendTextChunk = (textChunk) => {
+            if (!textChunk) {
+                return;
+            }
+            content += textChunk;
+            if (!hasReceivedModelOutput && content.trim().length > 0) {
+                hasReceivedModelOutput = true;
+                preparationToolCalls.length = 0;
+            }
+            emitProgress();
+        };
+        /**
+         * Consumes one decoded transport chunk, removing keep-alive pings and tool-call frames.
+         *
+         * Note: Tool-call JSON is line-delimited but may arrive split across transport chunks.
+         */
+        const processDecodedChunk = (decodedChunk) => {
+            var _a;
+            if (!decodedChunk) {
+                return;
+            }
+            const combinedChunk = pendingToolCallLineFragment + decodedChunk;
+            pendingToolCallLineFragment = '';
+            const hasTrailingNewline = combinedChunk.endsWith('\n') || combinedChunk.endsWith('\r');
+            const lines = combinedChunk.split(/\r?\n/);
+            const trailingFragment = hasTrailingNewline ? '' : ((_a = lines.pop()) !== null && _a !== void 0 ? _a : '');
+            let hasNonEmptyText = false;
+            const textLines = [];
+            for (const line of lines) {
+                const trimmedLine = line.trim();
+                if (trimmedLine === CHAT_STREAM_KEEP_ALIVE_TOKEN) {
+                    continue;
+                }
+                if (tryParseToolCallLine(trimmedLine)) {
+                    continue;
+                }
+                textLines.push(line);
+                if (trimmedLine.length > 0) {
+                    hasNonEmptyText = true;
+                }
+            }
+            if (trailingFragment !== '') {
+                const trimmedTrailingFragment = trailingFragment.trim();
+                if (isPotentialToolCallLineFragment(trimmedTrailingFragment)) {
+                    pendingToolCallLineFragment = trailingFragment;
+                }
+                else {
+                    textLines.push(trailingFragment);
+                    if (trimmedTrailingFragment.length > 0) {
+                        hasNonEmptyText = true;
+                    }
+                }
+            }
+            if (!hasNonEmptyText) {
+                return;
+            }
+            appendTextChunk(textLines.join('\n'));
+        };
         if (!bookResponse.body) {
             content = await bookResponse.text();
         }
@@ -26978,84 +27616,26 @@ class RemoteAgent extends Agent {
                     doneReading = !!done;
                     if (value) {
                         const textChunk = decoder.decode(value, { stream: true });
-                        let hasNonEmptyText = false;
-                        const textLines = [];
-                        const lines = textChunk.split(/\r?\n/);
-                        for (const line of lines) {
-                            const trimmedLine = line.trim();
-                            if (trimmedLine === CHAT_STREAM_KEEP_ALIVE_TOKEN) {
-                                continue;
-                            }
-                            let isToolCallLine = false;
-                            if (trimmedLine.startsWith('{') && trimmedLine.endsWith('}')) {
-                                try {
-                                    const chunk = JSON.parse(trimmedLine);
-                                    if (chunk.toolCalls) {
-                                        const normalizedToolCalls = chunk.toolCalls.map(normalizeToolCall);
-                                        upsertToolCalls(normalizedToolCalls);
-                                        onProgress({
-                                            content,
-                                            modelName: this.modelName,
-                                            timing: {},
-                                            usage: {},
-                                            rawPromptContent: {},
-                                            rawRequest: {},
-                                            rawResponse: {},
-                                            toolCalls: getActiveToolCalls(),
-                                        });
-                                        isToolCallLine = true;
-                                    }
-                                }
-                                catch (error) {
-                                    // Ignore non-json lines
-                                }
-                            }
-                            if (!isToolCallLine) {
-                                textLines.push(line);
-                                if (trimmedLine.length > 0) {
-                                    hasNonEmptyText = true;
-                                }
-                            }
-                        }
-                        if (!hasNonEmptyText) {
-                            continue;
-                        }
-                        const textChunkWithoutToolCalls = textLines.join('\n');
-                        content += textChunkWithoutToolCalls;
-                        if (!hasReceivedModelOutput && content.trim().length > 0) {
-                            hasReceivedModelOutput = true;
-                            preparationToolCalls.length = 0;
-                        }
-                        onProgress({
-                            content,
-                            modelName: this.modelName,
-                            timing: {},
-                            usage: {},
-                            rawPromptContent: {},
-                            rawRequest: {},
-                            rawResponse: {},
-                            toolCalls: getActiveToolCalls(),
-                        });
+                        processDecodedChunk(textChunk);
                     }
                 }
                 // Flush any remaining decoder internal state
                 const lastChunk = decoder.decode();
                 if (lastChunk) {
-                    content += lastChunk;
-                    if (!hasReceivedModelOutput && content.trim().length > 0) {
-                        hasReceivedModelOutput = true;
-                        preparationToolCalls.length = 0;
+                    processDecodedChunk(lastChunk);
+                }
+                if (pendingToolCallLineFragment) {
+                    const trimmedPending = pendingToolCallLineFragment.trim();
+                    if (trimmedPending === CHAT_STREAM_KEEP_ALIVE_TOKEN) {
+                        pendingToolCallLineFragment = '';
+                    }
+                    else if (tryParseToolCallLine(trimmedPending)) {
+                        pendingToolCallLineFragment = '';
+                    }
+                    else {
+                        appendTextChunk(pendingToolCallLineFragment);
+                        pendingToolCallLineFragment = '';
                     }
-                    onProgress({
-                        content: lastChunk,
-                        modelName: this.modelName,
-                        timing: {},
-                        usage: {},
-                        rawPromptContent: {},
-                        rawRequest: {},
-                        rawResponse: {},
-                        toolCalls: getActiveToolCalls(),
-                    });
                 }
             }
             finally {
@@ -28459,6 +29039,7 @@ const TOOL_TITLES = {
     run_browser: { title: 'Running browser', emoji: '🌐' },
     get_current_time: { title: 'Checking time', emoji: '🕒' },
     useTime: { title: 'Checking time', emoji: '🕒' },
+    get_user_location: { title: 'Checking location', emoji: '📍' },
     send_email: { title: 'Sending email', emoji: '📧' },
     useEmail: { title: 'Sending email', emoji: '📧' },
     // Add more tools here as needed
@@ -28719,8 +29300,8 @@ function ImagePromptRenderer({ alt, prompt }) {
     return (jsxs("div", { className: styles$5.imagePrompt, "aria-live": "polite", children: [jsxs("div", { className: styles$5.imagePromptPreview, children: [status === 'success' && imageUrl ? (jsx("img", { src: imageUrl, alt: alt, className: styles$5.imagePromptImage })) : (jsx("div", { className: styles$5.imagePromptPlaceholder, children: jsx("div", { className: styles$5.imagePromptSpinner }) })), status === 'error' && error && jsx("div", { className: styles$5.imagePromptError, children: error })] }), jsxs("div", { className: styles$5.imagePromptMeta, children: [jsx("span", { className: styles$5.imagePromptPrompt, children: trimmedPrompt || 'Generated image' }), jsx("span", { className: styles$5.imagePromptStatus, children: statusLabel })] })] }));
 }
 
-var css_248z$1 = ".ChatMessageMap-module_mapContainer__OBOgP{aspect-ratio:1/1;background:rgba(15,23,36,.94);border:1px solid hsla(0,0%,100%,.12);border-radius:16px;box-shadow:0 14px 50px rgba(2,6,23,.45);margin:16px 0;overflow:hidden;position:relative;width:100%}.ChatMessageMap-module_mapSurface__E713z{border-radius:inherit;height:100%;width:100%}.ChatMessageMap-module_mapControls__2VZT6{display:flex;gap:8px;position:absolute;right:10px;top:10px;z-index:2}.ChatMessageMap-module_mapControlButton__q5pgF{align-items:center;background:rgba(2,6,23,.75);border:none;border-radius:12px;box-shadow:0 6px 18px rgba(2,6,23,.45);color:#f8fafc;cursor:pointer;display:inline-flex;height:38px;justify-content:center;transition:background .2s ease,transform .2s ease;width:38px}.ChatMessageMap-module_mapControlButton__q5pgF:hover{background:rgba(59,130,246,.9);transform:translateY(-1px)}.ChatMessageMap-module_mapControlButton__q5pgF:focus-visible{outline:2px solid #38bdf8;outline-offset:2px}.ChatMessageMap-module_mapModalBackdrop__uC0ud{align-items:center;background:rgba(2,6,23,.85);display:flex;inset:0;justify-content:center;padding:20px;position:fixed;z-index:1100}.ChatMessageMap-module_mapModalContent__XaQyP{background:rgba(15,23,42,.98);border:1px solid hsla(0,0%,100%,.08);border-radius:24px;box-shadow:0 30px 70px rgba(2,6,23,.75);display:flex;flex-direction:column;gap:16px;max-height:min(90vh,720px);padding:20px 24px 24px;width:min(92vw,960px)}.ChatMessageMap-module_mapModalHeader__RRj5V{display:flex;justify-content:flex-end}.ChatMessageMap-module_mapModalCloseButton__vUs1S{align-items:center;background:hsla(0,0%,100%,.12);border:none;border-radius:12px;color:#f8fafc;cursor:pointer;display:inline-flex;height:38px;justify-content:center;transition:background .2s ease;width:38px}.ChatMessageMap-module_mapModalCloseButton__vUs1S:hover{background:hsla(0,0%,100%,.24)}.ChatMessageMap-module_mapModalCloseButton__vUs1S:focus-visible{outline:2px solid #38bdf8;outline-offset:2px}.ChatMessageMap-module_mapModalBody__T4vO-{display:flex;flex:1;min-height:320px}.ChatMessageMap-module_mapModalSurface__FWJgn{border-radius:16px;flex:1;height:100%;width:100%}@media (max-width:640px){.ChatMessageMap-module_mapContainer__OBOgP{border-radius:12px;margin:12px 0}.ChatMessageMap-module_mapControlButton__q5pgF{height:34px;width:34px}.ChatMessageMap-module_mapModalContent__XaQyP{border-radius:18px;max-height:90vh;padding:16px;width:100%}.ChatMessageMap-module_mapModalBody__T4vO-{min-height:260px}.ChatMessageMap-module_mapModalSurface__FWJgn{border-radius:12px}}\n/*# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIkNoYXRNZXNzYWdlTWFwLm1vZHVsZS5jc3MiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsMkNBTUksZ0JBQW1CLENBRm5CLDZCQUFrQyxDQURsQyxvQ0FBMkMsQ0FEM0Msa0JBQW1CLENBTW5CLHVDQUE0QyxDQUQ1QyxhQUFjLENBRmQsZUFBZ0IsQ0FJaEIsaUJBQWtCLENBUmxCLFVBU0osQ0FFQSx5Q0FHSSxxQkFBc0IsQ0FEdEIsV0FBWSxDQURaLFVBR0osQ0FFQSwwQ0FJSSxZQUFhLENBQ2IsT0FBUSxDQUpSLGlCQUFrQixDQUVsQixVQUFXLENBRFgsUUFBUyxDQUlULFNBQ0osQ0FFQSwrQ0FRSSxrQkFBbUIsQ0FIbkIsMkJBQWdDLENBRGhDLFdBQVksQ0FEWixrQkFBbUIsQ0FRbkIsc0NBQTJDLENBTDNDLGFBQWMsQ0FJZCxjQUFlLENBSGYsbUJBQW9CLENBTHBCLFdBQVksQ0FPWixzQkFBdUIsQ0FHdkIsaURBQXFELENBWHJELFVBWUosQ0FFQSxxREFDSSw4QkFBbUMsQ0FDbkMsMEJBQ0osQ0FFQSw2REFDSSx5QkFBMEIsQ0FDMUIsa0JBQ0osQ0FFQSwrQ0FNSSxrQkFBbUIsQ0FIbkIsMkJBQWdDLENBRWhDLFlBQWEsQ0FIYixPQUFRLENBS1Isc0JBQXVCLENBQ3ZCLFlBQWEsQ0FQYixjQUFlLENBR2YsWUFLSixDQUVBLDhDQUNJLDZCQUFrQyxDQVNsQyxvQ0FBMkMsQ0FSM0Msa0JBQW1CLENBR25CLHVDQUE0QyxDQUM1QyxZQUFhLENBQ2IscUJBQXNCLENBQ3RCLFFBQVMsQ0FKVCwwQkFBNEIsQ0FLNUIsc0JBQXVCLENBTnZCLHFCQVFKLENBRUEsNkNBQ0ksWUFBYSxDQUNiLHdCQUNKLENBRUEsa0RBUUksa0JBQW1CLENBSG5CLDhCQUFxQyxDQURyQyxXQUFZLENBRFosa0JBQW1CLENBR25CLGFBQWMsQ0FJZCxjQUFlLENBSGYsbUJBQW9CLENBTHBCLFdBQVksQ0FPWixzQkFBdUIsQ0FFdkIsOEJBQWdDLENBVmhDLFVBV0osQ0FFQSx3REFDSSw4QkFDSixDQUVBLGdFQUNJLHlCQUEwQixDQUMxQixrQkFDSixDQUVBLDJDQUdJLFlBQWEsQ0FGYixNQUFPLENBQ1AsZ0JBRUosQ0FFQSw4Q0FFSSxrQkFBbUIsQ0FEbkIsTUFBTyxDQUdQLFdBQVksQ0FEWixVQUVKLENBRUEseUJBQ0ksMkNBQ0ksa0JBQW1CLENBQ25CLGFBQ0osQ0FFQSwrQ0FFSSxXQUFZLENBRFosVUFFSixDQUVBLDhDQUlJLGtCQUFtQixDQUZuQixlQUFnQixDQUNoQixZQUFhLENBRmIsVUFJSixDQUVBLDJDQUNJLGdCQUNKLENBRUEsOENBQ0ksa0JBQ0osQ0FDSiIsImZpbGUiOiJDaGF0TWVzc2FnZU1hcC5tb2R1bGUuY3NzIiwic291cmNlc0NvbnRlbnQiOlsiLm1hcENvbnRhaW5lciB7XG4gICAgd2lkdGg6IDEwMCU7XG4gICAgYm9yZGVyLXJhZGl1czogMTZweDtcbiAgICBib3JkZXI6IDFweCBzb2xpZCByZ2JhKDI1NSwgMjU1LCAyNTUsIDAuMTIpO1xuICAgIGJhY2tncm91bmQ6IHJnYmEoMTUsIDIzLCAzNiwgMC45NCk7XG4gICAgb3ZlcmZsb3c6IGhpZGRlbjtcbiAgICBhc3BlY3QtcmF0aW86IDEgLyAxO1xuICAgIG1hcmdpbjogMTZweCAwO1xuICAgIGJveC1zaGFkb3c6IDAgMTRweCA1MHB4IHJnYmEoMiwgNiwgMjMsIDAuNDUpO1xuICAgIHBvc2l0aW9uOiByZWxhdGl2ZTtcbn1cblxuLm1hcFN1cmZhY2Uge1xuICAgIHdpZHRoOiAxMDAlO1xuICAgIGhlaWdodDogMTAwJTtcbiAgICBib3JkZXItcmFkaXVzOiBpbmhlcml0O1xufVxuXG4ubWFwQ29udHJvbHMge1xuICAgIHBvc2l0aW9uOiBhYnNvbHV0ZTtcbiAgICB0b3A6IDEwcHg7XG4gICAgcmlnaHQ6IDEwcHg7XG4gICAgZGlzcGxheTogZmxleDtcbiAgICBnYXA6IDhweDtcbiAgICB6LWluZGV4OiAyO1xufVxuXG4ubWFwQ29udHJvbEJ1dHRvbiB7XG4gICAgd2lkdGg6IDM4cHg7XG4gICAgaGVpZ2h0OiAzOHB4O1xuICAgIGJvcmRlci1yYWRpdXM6IDEycHg7XG4gICAgYm9yZGVyOiBub25lO1xuICAgIGJhY2tncm91bmQ6IHJnYmEoMiwgNiwgMjMsIDAuNzUpO1xuICAgIGNvbG9yOiAjZjhmYWZjO1xuICAgIGRpc3BsYXk6IGlubGluZS1mbGV4O1xuICAgIGFsaWduLWl0ZW1zOiBjZW50ZXI7XG4gICAganVzdGlmeS1jb250ZW50OiBjZW50ZXI7XG4gICAgY3Vyc29yOiBwb2ludGVyO1xuICAgIGJveC1zaGFkb3c6IDAgNnB4IDE4cHggcmdiYSgyLCA2LCAyMywgMC40NSk7XG4gICAgdHJhbnNpdGlvbjogYmFja2dyb3VuZCAwLjJzIGVhc2UsIHRyYW5zZm9ybSAwLjJzIGVhc2U7XG59XG5cbi5tYXBDb250cm9sQnV0dG9uOmhvdmVyIHtcbiAgICBiYWNrZ3JvdW5kOiByZ2JhKDU5LCAxMzAsIDI0NiwgMC45KTtcbiAgICB0cmFuc2Zvcm06IHRyYW5zbGF0ZVkoLTFweCk7XG59XG5cbi5tYXBDb250cm9sQnV0dG9uOmZvY3VzLXZpc2libGUge1xuICAgIG91dGxpbmU6IDJweCBzb2xpZCAjMzhiZGY4O1xuICAgIG91dGxpbmUtb2Zmc2V0OiAycHg7XG59XG5cbi5tYXBNb2RhbEJhY2tkcm9wIHtcbiAgICBwb3NpdGlvbjogZml4ZWQ7XG4gICAgaW5zZXQ6IDA7XG4gICAgYmFja2dyb3VuZDogcmdiYSgyLCA2LCAyMywgMC44NSk7XG4gICAgei1pbmRleDogMTEwMDtcbiAgICBkaXNwbGF5OiBmbGV4O1xuICAgIGFsaWduLWl0ZW1zOiBjZW50ZXI7XG4gICAganVzdGlmeS1jb250ZW50OiBjZW50ZXI7XG4gICAgcGFkZGluZzogMjBweDtcbn1cblxuLm1hcE1vZGFsQ29udGVudCB7XG4gICAgYmFja2dyb3VuZDogcmdiYSgxNSwgMjMsIDQyLCAwLjk4KTtcbiAgICBib3JkZXItcmFkaXVzOiAyNHB4O1xuICAgIHdpZHRoOiBtaW4oOTJ2dywgOTYwcHgpO1xuICAgIG1heC1oZWlnaHQ6IG1pbig5MHZoLCA3MjBweCk7XG4gICAgYm94LXNoYWRvdzogMCAzMHB4IDcwcHggcmdiYSgyLCA2LCAyMywgMC43NSk7XG4gICAgZGlzcGxheTogZmxleDtcbiAgICBmbGV4LWRpcmVjdGlvbjogY29sdW1uO1xuICAgIGdhcDogMTZweDtcbiAgICBwYWRkaW5nOiAyMHB4IDI0cHggMjRweDtcbiAgICBib3JkZXI6IDFweCBzb2xpZCByZ2JhKDI1NSwgMjU1LCAyNTUsIDAuMDgpO1xufVxuXG4ubWFwTW9kYWxIZWFkZXIge1xuICAgIGRpc3BsYXk6IGZsZXg7XG4gICAganVzdGlmeS1jb250ZW50OiBmbGV4LWVuZDtcbn1cblxuLm1hcE1vZGFsQ2xvc2VCdXR0b24ge1xuICAgIHdpZHRoOiAzOHB4O1xuICAgIGhlaWdodDogMzhweDtcbiAgICBib3JkZXItcmFkaXVzOiAxMnB4O1xuICAgIGJvcmRlcjogbm9uZTtcbiAgICBiYWNrZ3JvdW5kOiByZ2JhKDI1NSwgMjU1LCAyNTUsIDAuMTIpO1xuICAgIGNvbG9yOiAjZjhmYWZjO1xuICAgIGRpc3BsYXk6IGlubGluZS1mbGV4O1xuICAgIGFsaWduLWl0ZW1zOiBjZW50ZXI7XG4gICAganVzdGlmeS1jb250ZW50OiBjZW50ZXI7XG4gICAgY3Vyc29yOiBwb2ludGVyO1xuICAgIHRyYW5zaXRpb246IGJhY2tncm91bmQgMC4ycyBlYXNlO1xufVxuXG4ubWFwTW9kYWxDbG9zZUJ1dHRvbjpob3ZlciB7XG4gICAgYmFja2dyb3VuZDogcmdiYSgyNTUsIDI1NSwgMjU1LCAwLjI0KTtcbn1cblxuLm1hcE1vZGFsQ2xvc2VCdXR0b246Zm9jdXMtdmlzaWJsZSB7XG4gICAgb3V0bGluZTogMnB4IHNvbGlkICMzOGJkZjg7XG4gICAgb3V0bGluZS1vZmZzZXQ6IDJweDtcbn1cblxuLm1hcE1vZGFsQm9keSB7XG4gICAgZmxleDogMTtcbiAgICBtaW4taGVpZ2h0OiAzMjBweDtcbiAgICBkaXNwbGF5OiBmbGV4O1xufVxuXG4ubWFwTW9kYWxTdXJmYWNlIHtcbiAgICBmbGV4OiAxO1xuICAgIGJvcmRlci1yYWRpdXM6IDE2cHg7XG4gICAgd2lkdGg6IDEwMCU7XG4gICAgaGVpZ2h0OiAxMDAlO1xufVxuXG5AbWVkaWEgKG1heC13aWR0aDogNjQwcHgpIHtcbiAgICAubWFwQ29udGFpbmVyIHtcbiAgICAgICAgYm9yZGVyLXJhZGl1czogMTJweDtcbiAgICAgICAgbWFyZ2luOiAxMnB4IDA7XG4gICAgfVxuXG4gICAgLm1hcENvbnRyb2xCdXR0b24ge1xuICAgICAgICB3aWR0aDogMzRweDtcbiAgICAgICAgaGVpZ2h0OiAzNHB4O1xuICAgIH1cblxuICAgIC5tYXBNb2RhbENvbnRlbnQge1xuICAgICAgICB3aWR0aDogMTAwJTtcbiAgICAgICAgbWF4LWhlaWdodDogOTB2aDtcbiAgICAgICAgcGFkZGluZzogMTZweDtcbiAgICAgICAgYm9yZGVyLXJhZGl1czogMThweDtcbiAgICB9XG5cbiAgICAubWFwTW9kYWxCb2R5IHtcbiAgICAgICAgbWluLWhlaWdodDogMjYwcHg7XG4gICAgfVxuXG4gICAgLm1hcE1vZGFsU3VyZmFjZSB7XG4gICAgICAgIGJvcmRlci1yYWRpdXM6IDEycHg7XG4gICAgfVxufVxuIl19 */";
-var styles$1 = {"mapContainer":"ChatMessageMap-module_mapContainer__OBOgP","mapSurface":"ChatMessageMap-module_mapSurface__E713z","mapControls":"ChatMessageMap-module_mapControls__2VZT6","mapControlButton":"ChatMessageMap-module_mapControlButton__q5pgF","mapModalBackdrop":"ChatMessageMap-module_mapModalBackdrop__uC0ud","mapModalContent":"ChatMessageMap-module_mapModalContent__XaQyP","mapModalHeader":"ChatMessageMap-module_mapModalHeader__RRj5V","mapModalCloseButton":"ChatMessageMap-module_mapModalCloseButton__vUs1S","mapModalBody":"ChatMessageMap-module_mapModalBody__T4vO-","mapModalSurface":"ChatMessageMap-module_mapModalSurface__FWJgn"};
+var css_248z$1 = ".ChatMessageMap-module_mapContainer__OBOgP{aspect-ratio:1/1;background:rgba(15,23,36,.94);border:1px solid hsla(0,0%,100%,.12);border-radius:16px;box-shadow:0 14px 50px rgba(2,6,23,.45);margin:16px 0;overflow:hidden;position:relative;width:100%}.ChatMessageMap-module_mapSurface__E713z{border-radius:inherit;height:100%;width:100%}.ChatMessageMap-module_poiMarkerIcon__LPNik{align-items:center;background:radial-gradient(circle at 30% 30%,#fdf7c1,#fb923c 60%,#ea580c);border-radius:50%;box-shadow:0 6px 18px rgba(249,115,22,.5),inset 0 0 10px rgba(251,191,36,.6);display:inline-flex;font-weight:600;height:38px;justify-content:center;position:relative;transform:translateZ(0);width:38px}.ChatMessageMap-module_poiMarkerPulse__5flBS{animation:ChatMessageMap-module_poiPulse__O5mLt 1.6s ease-out infinite;background:rgba(251,146,60,.35);border-radius:50%;filter:blur(.5px);inset:0;position:absolute}.ChatMessageMap-module_poiMarkerInitial__HfA6H{color:#0f172a;font-size:12px;letter-spacing:.05em;line-height:1;text-transform:uppercase;z-index:1}.ChatMessageMap-module_mapTooltip__p4sIO{background:rgba(15,23,42,.95)!important;border:1px solid rgba(56,189,248,.45)!important;border-radius:999px!important;box-shadow:0 10px 25px rgba(2,6,23,.6)!important;color:#f8fafc!important;font-size:.75rem;padding:4px 12px!important;pointer-events:none}@keyframes ChatMessageMap-module_poiPulse__O5mLt{0%{opacity:.6;transform:scale(.6)}70%{opacity:0;transform:scale(1.2)}to{opacity:0}}.ChatMessageMap-module_mapControls__2VZT6{display:flex;gap:8px;position:absolute;right:10px;top:10px;z-index:2}.ChatMessageMap-module_mapControlButton__q5pgF{align-items:center;background:rgba(2,6,23,.75);border:none;border-radius:12px;box-shadow:0 6px 18px rgba(2,6,23,.45);color:#f8fafc;cursor:pointer;display:inline-flex;height:38px;justify-content:center;transition:background .2s ease,transform .2s ease;width:38px}.ChatMessageMap-module_mapControlButton__q5pgF:hover{background:rgba(59,130,246,.9);transform:translateY(-1px)}.ChatMessageMap-module_mapControlButton__q5pgF:focus-visible{outline:2px solid #38bdf8;outline-offset:2px}.ChatMessageMap-module_mapModalBackdrop__uC0ud{align-items:center;background:rgba(2,6,23,.85);display:flex;inset:0;justify-content:center;padding:20px;position:fixed;z-index:1100}.ChatMessageMap-module_mapModalContent__XaQyP{background:rgba(15,23,42,.98);border:1px solid hsla(0,0%,100%,.08);border-radius:24px;box-shadow:0 30px 70px rgba(2,6,23,.75);display:flex;flex-direction:column;gap:16px;max-height:min(90vh,720px);padding:20px 24px 24px;width:min(92vw,960px)}.ChatMessageMap-module_mapModalHeader__RRj5V{display:flex;justify-content:flex-end}.ChatMessageMap-module_mapModalCloseButton__vUs1S{align-items:center;background:hsla(0,0%,100%,.12);border:none;border-radius:12px;color:#f8fafc;cursor:pointer;display:inline-flex;height:38px;justify-content:center;transition:background .2s ease;width:38px}.ChatMessageMap-module_mapModalCloseButton__vUs1S:hover{background:hsla(0,0%,100%,.24)}.ChatMessageMap-module_mapModalCloseButton__vUs1S:focus-visible{outline:2px solid #38bdf8;outline-offset:2px}.ChatMessageMap-module_mapModalBody__T4vO-{display:flex;flex:1;min-height:320px}.ChatMessageMap-module_mapModalSurface__FWJgn{border-radius:16px;flex:1;height:100%;width:100%}@media (max-width:640px){.ChatMessageMap-module_mapContainer__OBOgP{border-radius:12px;margin:12px 0}.ChatMessageMap-module_mapControlButton__q5pgF{height:34px;width:34px}.ChatMessageMap-module_mapModalContent__XaQyP{border-radius:18px;max-height:90vh;padding:16px;width:100%}.ChatMessageMap-module_mapModalBody__T4vO-{min-height:260px}.ChatMessageMap-module_mapModalSurface__FWJgn{border-radius:12px}}\n/*# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIkNoYXRNZXNzYWdlTWFwLm1vZHVsZS5jc3MiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsMkNBTUksZ0JBQW1CLENBRm5CLDZCQUFrQyxDQURsQyxvQ0FBMkMsQ0FEM0Msa0JBQW1CLENBTW5CLHVDQUE0QyxDQUQ1QyxhQUFjLENBRmQsZUFBZ0IsQ0FJaEIsaUJBQWtCLENBUmxCLFVBU0osQ0FFQSx5Q0FHSSxxQkFBc0IsQ0FEdEIsV0FBWSxDQURaLFVBR0osQ0FFQSw0Q0FPSSxrQkFBbUIsQ0FIbkIseUVBQTZFLENBRDdFLGlCQUFrQixDQUVsQiw0RUFBc0YsQ0FDdEYsbUJBQW9CLENBSXBCLGVBQWdCLENBUmhCLFdBQVksQ0FNWixzQkFBdUIsQ0FDdkIsaUJBQWtCLENBRWxCLHVCQUErQixDQVYvQixVQVdKLENBRUEsNkNBS0ksc0VBQTBDLENBRDFDLCtCQUFvQyxDQURwQyxpQkFBa0IsQ0FHbEIsaUJBQW1CLENBSm5CLE9BQVEsQ0FEUixpQkFNSixDQUVBLCtDQUVJLGFBQWMsQ0FDZCxjQUFlLENBR2Ysb0JBQXNCLENBRnRCLGFBQWMsQ0FDZCx3QkFBeUIsQ0FKekIsU0FNSixDQUVBLHlDQUNJLHVDQUE2QyxDQUM3QywrQ0FBcUQsQ0FFckQsNkJBQStCLENBRy9CLGdEQUFzRCxDQUp0RCx1QkFBeUIsQ0FHekIsZ0JBQWtCLENBRGxCLDBCQUE0QixDQUc1QixtQkFDSixDQUVBLGlEQUNJLEdBRUksVUFBWSxDQURaLG1CQUVKLENBQ0EsSUFFSSxTQUFVLENBRFYsb0JBRUosQ0FDQSxHQUNJLFNBQ0osQ0FDSixDQUVBLDBDQUlJLFlBQWEsQ0FDYixPQUFRLENBSlIsaUJBQWtCLENBRWxCLFVBQVcsQ0FEWCxRQUFTLENBSVQsU0FDSixDQUVBLCtDQVFJLGtCQUFtQixDQUhuQiwyQkFBZ0MsQ0FEaEMsV0FBWSxDQURaLGtCQUFtQixDQVFuQixzQ0FBMkMsQ0FMM0MsYUFBYyxDQUlkLGNBQWUsQ0FIZixtQkFBb0IsQ0FMcEIsV0FBWSxDQU9aLHNCQUF1QixDQUd2QixpREFBcUQsQ0FYckQsVUFZSixDQUVBLHFEQUNJLDhCQUFtQyxDQUNuQywwQkFDSixDQUVBLDZEQUNJLHlCQUEwQixDQUMxQixrQkFDSixDQUVBLCtDQU1JLGtCQUFtQixDQUhuQiwyQkFBZ0MsQ0FFaEMsWUFBYSxDQUhiLE9BQVEsQ0FLUixzQkFBdUIsQ0FDdkIsWUFBYSxDQVBiLGNBQWUsQ0FHZixZQUtKLENBRUEsOENBQ0ksNkJBQWtDLENBU2xDLG9DQUEyQyxDQVIzQyxrQkFBbUIsQ0FHbkIsdUNBQTRDLENBQzVDLFlBQWEsQ0FDYixxQkFBc0IsQ0FDdEIsUUFBUyxDQUpULDBCQUE0QixDQUs1QixzQkFBdUIsQ0FOdkIscUJBUUosQ0FFQSw2Q0FDSSxZQUFhLENBQ2Isd0JBQ0osQ0FFQSxrREFRSSxrQkFBbUIsQ0FIbkIsOEJBQXFDLENBRHJDLFdBQVksQ0FEWixrQkFBbUIsQ0FHbkIsYUFBYyxDQUlkLGNBQWUsQ0FIZixtQkFBb0IsQ0FMcEIsV0FBWSxDQU9aLHNCQUF1QixDQUV2Qiw4QkFBZ0MsQ0FWaEMsVUFXSixDQUVBLHdEQUNJLDhCQUNKLENBRUEsZ0VBQ0kseUJBQTBCLENBQzFCLGtCQUNKLENBRUEsMkNBR0ksWUFBYSxDQUZiLE1BQU8sQ0FDUCxnQkFFSixDQUVBLDhDQUVJLGtCQUFtQixDQURuQixNQUFPLENBR1AsV0FBWSxDQURaLFVBRUosQ0FFQSx5QkFDSSwyQ0FDSSxrQkFBbUIsQ0FDbkIsYUFDSixDQUVBLCtDQUVJLFdBQVksQ0FEWixVQUVKLENBRUEsOENBSUksa0JBQW1CLENBRm5CLGVBQWdCLENBQ2hCLFlBQWEsQ0FGYixVQUlKLENBRUEsMkNBQ0ksZ0JBQ0osQ0FFQSw4Q0FDSSxrQkFDSixDQUNKIiwiZmlsZSI6IkNoYXRNZXNzYWdlTWFwLm1vZHVsZS5jc3MiLCJzb3VyY2VzQ29udGVudCI6WyIubWFwQ29udGFpbmVyIHtcbiAgICB3aWR0aDogMTAwJTtcbiAgICBib3JkZXItcmFkaXVzOiAxNnB4O1xuICAgIGJvcmRlcjogMXB4IHNvbGlkIHJnYmEoMjU1LCAyNTUsIDI1NSwgMC4xMik7XG4gICAgYmFja2dyb3VuZDogcmdiYSgxNSwgMjMsIDM2LCAwLjk0KTtcbiAgICBvdmVyZmxvdzogaGlkZGVuO1xuICAgIGFzcGVjdC1yYXRpbzogMSAvIDE7XG4gICAgbWFyZ2luOiAxNnB4IDA7XG4gICAgYm94LXNoYWRvdzogMCAxNHB4IDUwcHggcmdiYSgyLCA2LCAyMywgMC40NSk7XG4gICAgcG9zaXRpb246IHJlbGF0aXZlO1xufVxuXG4ubWFwU3VyZmFjZSB7XG4gICAgd2lkdGg6IDEwMCU7XG4gICAgaGVpZ2h0OiAxMDAlO1xuICAgIGJvcmRlci1yYWRpdXM6IGluaGVyaXQ7XG59XG5cbi5wb2lNYXJrZXJJY29uIHtcbiAgICB3aWR0aDogMzhweDtcbiAgICBoZWlnaHQ6IDM4cHg7XG4gICAgYm9yZGVyLXJhZGl1czogNTAlO1xuICAgIGJhY2tncm91bmQ6IHJhZGlhbC1ncmFkaWVudChjaXJjbGUgYXQgMzAlIDMwJSwgI2ZkZjdjMSwgI2ZiOTIzYyA2MCUsICNlYTU4MGMpO1xuICAgIGJveC1zaGFkb3c6IDAgNnB4IDE4cHggcmdiYSgyNDksIDExNSwgMjIsIDAuNSksIGluc2V0IDAgMCAxMHB4IHJnYmEoMjUxLCAxOTEsIDM2LCAwLjYpO1xuICAgIGRpc3BsYXk6IGlubGluZS1mbGV4O1xuICAgIGFsaWduLWl0ZW1zOiBjZW50ZXI7XG4gICAganVzdGlmeS1jb250ZW50OiBjZW50ZXI7XG4gICAgcG9zaXRpb246IHJlbGF0aXZlO1xuICAgIGZvbnQtd2VpZ2h0OiA2MDA7XG4gICAgdHJhbnNmb3JtOiB0cmFuc2xhdGUzZCgwLCAwLCAwKTtcbn1cblxuLnBvaU1hcmtlclB1bHNlIHtcbiAgICBwb3NpdGlvbjogYWJzb2x1dGU7XG4gICAgaW5zZXQ6IDA7XG4gICAgYm9yZGVyLXJhZGl1czogNTAlO1xuICAgIGJhY2tncm91bmQ6IHJnYmEoMjUxLCAxNDYsIDYwLCAwLjM1KTtcbiAgICBhbmltYXRpb246IHBvaVB1bHNlIDEuNnMgZWFzZS1vdXQgaW5maW5pdGU7XG4gICAgZmlsdGVyOiBibHVyKDAuNXB4KTtcbn1cblxuLnBvaU1hcmtlckluaXRpYWwge1xuICAgIHotaW5kZXg6IDE7XG4gICAgY29sb3I6ICMwZjE3MmE7XG4gICAgZm9udC1zaXplOiAxMnB4O1xuICAgIGxpbmUtaGVpZ2h0OiAxO1xuICAgIHRleHQtdHJhbnNmb3JtOiB1cHBlcmNhc2U7XG4gICAgbGV0dGVyLXNwYWNpbmc6IDAuMDVlbTtcbn1cblxuLm1hcFRvb2x0aXAge1xuICAgIGJhY2tncm91bmQ6IHJnYmEoMTUsIDIzLCA0MiwgMC45NSkgIWltcG9ydGFudDtcbiAgICBib3JkZXI6IDFweCBzb2xpZCByZ2JhKDU2LCAxODksIDI0OCwgMC40NSkgIWltcG9ydGFudDtcbiAgICBjb2xvcjogI2Y4ZmFmYyAhaW1wb3J0YW50O1xuICAgIGJvcmRlci1yYWRpdXM6IDk5OXB4ICFpbXBvcnRhbnQ7XG4gICAgcGFkZGluZzogNHB4IDEycHggIWltcG9ydGFudDtcbiAgICBmb250LXNpemU6IDAuNzVyZW07XG4gICAgYm94LXNoYWRvdzogMCAxMHB4IDI1cHggcmdiYSgyLCA2LCAyMywgMC42KSAhaW1wb3J0YW50O1xuICAgIHBvaW50ZXItZXZlbnRzOiBub25lO1xufVxuXG5Aa2V5ZnJhbWVzIHBvaVB1bHNlIHtcbiAgICAwJSB7XG4gICAgICAgIHRyYW5zZm9ybTogc2NhbGUoMC42KTtcbiAgICAgICAgb3BhY2l0eTogMC42O1xuICAgIH1cbiAgICA3MCUge1xuICAgICAgICB0cmFuc2Zvcm06IHNjYWxlKDEuMik7XG4gICAgICAgIG9wYWNpdHk6IDA7XG4gICAgfVxuICAgIDEwMCUge1xuICAgICAgICBvcGFjaXR5OiAwO1xuICAgIH1cbn1cblxuLm1hcENvbnRyb2xzIHtcbiAgICBwb3NpdGlvbjogYWJzb2x1dGU7XG4gICAgdG9wOiAxMHB4O1xuICAgIHJpZ2h0OiAxMHB4O1xuICAgIGRpc3BsYXk6IGZsZXg7XG4gICAgZ2FwOiA4cHg7XG4gICAgei1pbmRleDogMjtcbn1cblxuLm1hcENvbnRyb2xCdXR0b24ge1xuICAgIHdpZHRoOiAzOHB4O1xuICAgIGhlaWdodDogMzhweDtcbiAgICBib3JkZXItcmFkaXVzOiAxMnB4O1xuICAgIGJvcmRlcjogbm9uZTtcbiAgICBiYWNrZ3JvdW5kOiByZ2JhKDIsIDYsIDIzLCAwLjc1KTtcbiAgICBjb2xvcjogI2Y4ZmFmYztcbiAgICBkaXNwbGF5OiBpbmxpbmUtZmxleDtcbiAgICBhbGlnbi1pdGVtczogY2VudGVyO1xuICAgIGp1c3RpZnktY29udGVudDogY2VudGVyO1xuICAgIGN1cnNvcjogcG9pbnRlcjtcbiAgICBib3gtc2hhZG93OiAwIDZweCAxOHB4IHJnYmEoMiwgNiwgMjMsIDAuNDUpO1xuICAgIHRyYW5zaXRpb246IGJhY2tncm91bmQgMC4ycyBlYXNlLCB0cmFuc2Zvcm0gMC4ycyBlYXNlO1xufVxuXG4ubWFwQ29udHJvbEJ1dHRvbjpob3ZlciB7XG4gICAgYmFja2dyb3VuZDogcmdiYSg1OSwgMTMwLCAyNDYsIDAuOSk7XG4gICAgdHJhbnNmb3JtOiB0cmFuc2xhdGVZKC0xcHgpO1xufVxuXG4ubWFwQ29udHJvbEJ1dHRvbjpmb2N1cy12aXNpYmxlIHtcbiAgICBvdXRsaW5lOiAycHggc29saWQgIzM4YmRmODtcbiAgICBvdXRsaW5lLW9mZnNldDogMnB4O1xufVxuXG4ubWFwTW9kYWxCYWNrZHJvcCB7XG4gICAgcG9zaXRpb246IGZpeGVkO1xuICAgIGluc2V0OiAwO1xuICAgIGJhY2tncm91bmQ6IHJnYmEoMiwgNiwgMjMsIDAuODUpO1xuICAgIHotaW5kZXg6IDExMDA7XG4gICAgZGlzcGxheTogZmxleDtcbiAgICBhbGlnbi1pdGVtczogY2VudGVyO1xuICAgIGp1c3RpZnktY29udGVudDogY2VudGVyO1xuICAgIHBhZGRpbmc6IDIwcHg7XG59XG5cbi5tYXBNb2RhbENvbnRlbnQge1xuICAgIGJhY2tncm91bmQ6IHJnYmEoMTUsIDIzLCA0MiwgMC45OCk7XG4gICAgYm9yZGVyLXJhZGl1czogMjRweDtcbiAgICB3aWR0aDogbWluKDkydncsIDk2MHB4KTtcbiAgICBtYXgtaGVpZ2h0OiBtaW4oOTB2aCwgNzIwcHgpO1xuICAgIGJveC1zaGFkb3c6IDAgMzBweCA3MHB4IHJnYmEoMiwgNiwgMjMsIDAuNzUpO1xuICAgIGRpc3BsYXk6IGZsZXg7XG4gICAgZmxleC1kaXJlY3Rpb246IGNvbHVtbjtcbiAgICBnYXA6IDE2cHg7XG4gICAgcGFkZGluZzogMjBweCAyNHB4IDI0cHg7XG4gICAgYm9yZGVyOiAxcHggc29saWQgcmdiYSgyNTUsIDI1NSwgMjU1LCAwLjA4KTtcbn1cblxuLm1hcE1vZGFsSGVhZGVyIHtcbiAgICBkaXNwbGF5OiBmbGV4O1xuICAgIGp1c3RpZnktY29udGVudDogZmxleC1lbmQ7XG59XG5cbi5tYXBNb2RhbENsb3NlQnV0dG9uIHtcbiAgICB3aWR0aDogMzhweDtcbiAgICBoZWlnaHQ6IDM4cHg7XG4gICAgYm9yZGVyLXJhZGl1czogMTJweDtcbiAgICBib3JkZXI6IG5vbmU7XG4gICAgYmFja2dyb3VuZDogcmdiYSgyNTUsIDI1NSwgMjU1LCAwLjEyKTtcbiAgICBjb2xvcjogI2Y4ZmFmYztcbiAgICBkaXNwbGF5OiBpbmxpbmUtZmxleDtcbiAgICBhbGlnbi1pdGVtczogY2VudGVyO1xuICAgIGp1c3RpZnktY29udGVudDogY2VudGVyO1xuICAgIGN1cnNvcjogcG9pbnRlcjtcbiAgICB0cmFuc2l0aW9uOiBiYWNrZ3JvdW5kIDAuMnMgZWFzZTtcbn1cblxuLm1hcE1vZGFsQ2xvc2VCdXR0b246aG92ZXIge1xuICAgIGJhY2tncm91bmQ6IHJnYmEoMjU1LCAyNTUsIDI1NSwgMC4yNCk7XG59XG5cbi5tYXBNb2RhbENsb3NlQnV0dG9uOmZvY3VzLXZpc2libGUge1xuICAgIG91dGxpbmU6IDJweCBzb2xpZCAjMzhiZGY4O1xuICAgIG91dGxpbmUtb2Zmc2V0OiAycHg7XG59XG5cbi5tYXBNb2RhbEJvZHkge1xuICAgIGZsZXg6IDE7XG4gICAgbWluLWhlaWdodDogMzIwcHg7XG4gICAgZGlzcGxheTogZmxleDtcbn1cblxuLm1hcE1vZGFsU3VyZmFjZSB7XG4gICAgZmxleDogMTtcbiAgICBib3JkZXItcmFkaXVzOiAxNnB4O1xuICAgIHdpZHRoOiAxMDAlO1xuICAgIGhlaWdodDogMTAwJTtcbn1cblxuQG1lZGlhIChtYXgtd2lkdGg6IDY0MHB4KSB7XG4gICAgLm1hcENvbnRhaW5lciB7XG4gICAgICAgIGJvcmRlci1yYWRpdXM6IDEycHg7XG4gICAgICAgIG1hcmdpbjogMTJweCAwO1xuICAgIH1cblxuICAgIC5tYXBDb250cm9sQnV0dG9uIHtcbiAgICAgICAgd2lkdGg6IDM0cHg7XG4gICAgICAgIGhlaWdodDogMzRweDtcbiAgICB9XG5cbiAgICAubWFwTW9kYWxDb250ZW50IHtcbiAgICAgICAgd2lkdGg6IDEwMCU7XG4gICAgICAgIG1heC1oZWlnaHQ6IDkwdmg7XG4gICAgICAgIHBhZGRpbmc6IDE2cHg7XG4gICAgICAgIGJvcmRlci1yYWRpdXM6IDE4cHg7XG4gICAgfVxuXG4gICAgLm1hcE1vZGFsQm9keSB7XG4gICAgICAgIG1pbi1oZWlnaHQ6IDI2MHB4O1xuICAgIH1cblxuICAgIC5tYXBNb2RhbFN1cmZhY2Uge1xuICAgICAgICBib3JkZXItcmFkaXVzOiAxMnB4O1xuICAgIH1cbn1cbiJdfQ== */";
+var styles$1 = {"mapContainer":"ChatMessageMap-module_mapContainer__OBOgP","mapSurface":"ChatMessageMap-module_mapSurface__E713z","poiMarkerIcon":"ChatMessageMap-module_poiMarkerIcon__LPNik","poiMarkerPulse":"ChatMessageMap-module_poiMarkerPulse__5flBS","poiPulse":"ChatMessageMap-module_poiPulse__O5mLt","poiMarkerInitial":"ChatMessageMap-module_poiMarkerInitial__HfA6H","mapTooltip":"ChatMessageMap-module_mapTooltip__p4sIO","mapControls":"ChatMessageMap-module_mapControls__2VZT6","mapControlButton":"ChatMessageMap-module_mapControlButton__q5pgF","mapModalBackdrop":"ChatMessageMap-module_mapModalBackdrop__uC0ud","mapModalContent":"ChatMessageMap-module_mapModalContent__XaQyP","mapModalHeader":"ChatMessageMap-module_mapModalHeader__RRj5V","mapModalCloseButton":"ChatMessageMap-module_mapModalCloseButton__vUs1S","mapModalBody":"ChatMessageMap-module_mapModalBody__T4vO-","mapModalSurface":"ChatMessageMap-module_mapModalSurface__FWJgn"};
 styleInject(css_248z$1);
 
 /**
@@ -28729,6 +29310,206 @@ styleInject(css_248z$1);
  * @private internal helper of `<ChatMessageItem/>`
  */
 const DEFAULT_LAYER_ID = 'chat-message-map-layer';
+/**
+ * Style tokens used to make GeoJSON paths and polygons feel more modern.
+ *
+ * @private internal helper of `<ChatMessageMap/>`
+ */
+const GEOJSON_STYLE_PRESETS = {
+    polygon: {
+        color: '#38bdf8',
+        weight: 2,
+        opacity: 0.95,
+        fillColor: 'rgba(59, 130, 246, 0.28)',
+        fillOpacity: 0.35,
+        dashArray: '6 8',
+        lineCap: 'round',
+        lineJoin: 'round',
+    },
+    line: {
+        color: '#67e8f9',
+        weight: 3,
+        opacity: 0.92,
+        dashArray: '5 7',
+        lineCap: 'round',
+        lineJoin: 'round',
+    },
+    highlight: {
+        color: '#7dd3fc',
+        weight: 4,
+        fillOpacity: 0.55,
+    },
+    default: {
+        color: '#6ee7b7',
+        weight: 2.5,
+        opacity: 0.9,
+        dashArray: '4 6',
+        lineCap: 'round',
+        lineJoin: 'round',
+    },
+};
+/**
+ * Dimensions and anchor offsets for the custom point-of-interest markers.
+ *
+ * @private internal helper of `<ChatMessageMap/>`
+ */
+const POI_MARKER_CONFIG = {
+    size: 38,
+    anchor: [19, 19],
+};
+/**
+ * Offset used for map tooltips so labels sit above the features.
+ *
+ * @private internal helper of `<ChatMessageMap/>`
+ */
+const MAP_TOOLTIP_OFFSET = [0, -20];
+/**
+ * Returns the preferred label for a GeoJSON feature by checking common property keys.
+ *
+ * @param feature - Feature to inspect for identifying properties.
+ * @returns A trimmed string label or `null` when no candidate is available.
+ *
+ * @private internal helper of `<ChatMessageMap/>`
+ */
+function getGeoJsonFeatureLabel(feature) {
+    const properties = feature.properties;
+    if (properties && typeof properties === 'object') {
+        const bag = properties;
+        for (const key of ['name', 'title', 'label', 'description']) {
+            const value = bag[key];
+            if (typeof value === 'string' && value.trim().length > 0) {
+                return value.trim();
+            }
+        }
+    }
+    if (typeof feature.id === 'string' && feature.id.trim().length > 0) {
+        return feature.id.trim();
+    }
+    if (typeof feature.id === 'number') {
+        return feature.id.toString();
+    }
+    return null;
+}
+/**
+ * Provides a base style object for GeoJSON paths so polygons, lines, and fallbacks get distinct strokes.
+ *
+ * @param feature - Feature driving the style calculation.
+ * @returns A fresh `PathOptions` instance describing stroke/fill tokens.
+ *
+ * @private internal helper of `<ChatMessageMap/>`
+ */
+function getGeoJsonFeatureStyle(feature) {
+    var _a;
+    const geometryType = (_a = feature === null || feature === void 0 ? void 0 : feature.geometry) === null || _a === void 0 ? void 0 : _a.type;
+    if (geometryType === 'Polygon' || geometryType === 'MultiPolygon') {
+        return { ...GEOJSON_STYLE_PRESETS.polygon };
+    }
+    if (geometryType === 'LineString' || geometryType === 'MultiLineString') {
+        return { ...GEOJSON_STYLE_PRESETS.line };
+    }
+    return { ...GEOJSON_STYLE_PRESETS.default };
+}
+/**
+ * Builds a highlighted style variant for hover states while respecting the base tokens.
+ *
+ * @param baseStyle - Style to ramp up for the hover effect.
+ * @returns A new `PathOptions` instance with stronger stroke/fill emphasis.
+ *
+ * @private internal helper of `<ChatMessageMap/>`
+ */
+function getGeoJsonHighlightStyle(baseStyle) {
+    var _a, _b, _c;
+    return {
+        ...baseStyle,
+        color: (_a = GEOJSON_STYLE_PRESETS.highlight.color) !== null && _a !== void 0 ? _a : baseStyle.color,
+        weight: Math.max((_b = baseStyle.weight) !== null && _b !== void 0 ? _b : 2, 1) * 1.3,
+        fillOpacity: Math.min(0.6, ((_c = baseStyle.fillOpacity) !== null && _c !== void 0 ? _c : 0.2) + 0.25),
+    };
+}
+/**
+ * Guards Leaflet layers that support `setStyle`.
+ *
+ * @param layer - Candidate Leaflet layer to check.
+ * @returns `true` when the supplied layer exposes `Path` styling helpers.
+ *
+ * @private internal helper of `<ChatMessageMap/>`
+ */
+function isLeafletPathLayer(layer) {
+    return typeof layer.setStyle === 'function';
+}
+/**
+ * Attaches tooltips, hover highlights, and accessibility helpers to GeoJSON layers.
+ *
+ * @param feature - Feature backing the Leaflet layer.
+ * @param layer - Leaflet layer created for the feature.
+ *
+ * @private internal helper of `<ChatMessageMap/>`
+ */
+function decorateGeoJsonLayer(feature, layer) {
+    const label = getGeoJsonFeatureLabel(feature);
+    if (label) {
+        layer.bindTooltip(label, {
+            direction: 'top',
+            offset: MAP_TOOLTIP_OFFSET,
+            className: styles$1.mapTooltip,
+        });
+    }
+    if (!isLeafletPathLayer(layer)) {
+        return;
+    }
+    const baseStyle = getGeoJsonFeatureStyle(feature);
+    layer.on('mouseover', () => {
+        layer.setStyle(getGeoJsonHighlightStyle(baseStyle));
+    });
+    layer.on('mouseout', () => {
+        layer.setStyle(baseStyle);
+    });
+}
+/**
+ * Renders a custom point-of-interest marker for point features.
+ *
+ * @param feature - Feature describing the point.
+ * @param latlng - Coordinates where the marker should appear.
+ * @returns Leaflet marker with layered glow and optional initial text.
+ *
+ * @private internal helper of `<ChatMessageMap/>`
+ */
+function createPointOfInterestMarker(feature, latlng) {
+    const label = getGeoJsonFeatureLabel(feature);
+    const initial = label ? label.trim().charAt(0).toLocaleUpperCase() : '';
+    const initialHtml = initial
+        ? `<span class="${styles$1.poiMarkerInitial}" aria-hidden="true">${escapeHtml(initial)}</span>`
+        : '';
+    const icon = L.divIcon({
+        className: styles$1.poiMarkerIcon,
+        html: `
+            <span class="${styles$1.poiMarkerPulse}" aria-hidden="true"></span>
+            ${initialHtml}
+        `.trim(),
+        iconSize: [POI_MARKER_CONFIG.size, POI_MARKER_CONFIG.size],
+        iconAnchor: POI_MARKER_CONFIG.anchor,
+    });
+    return L.marker(latlng, {
+        icon,
+        riseOnHover: true,
+    });
+}
+/**
+ * Escapes HTML-sensitive characters to keep raw GeoJSON properties safe when injected into markup.
+ *
+ * @param value - Source string to escape.
+ * @returns Escaped string safe for insertion into HTML fragments.
+ *
+ * @private internal helper of `<ChatMessageMap/>`
+ */
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
 /**
  * Custom hook that renders a Leaflet map inside the provided container and keeps it synced with the geojson payload.
  *
@@ -28764,17 +29545,9 @@ function useLeafletGeoJsonMap(containerRef, data, enabled) {
         });
         layer.addTo(map);
         const geoJsonLayer = L.geoJSON(data, {
-            style: () => ({
-                color: '#6EE7B7',
-                weight: 3,
-            }),
-            pointToLayer: (_feature, latlng) => L.circleMarker(latlng, {
-                radius: 6,
-                fillColor: '#f59e0b',
-                color: '#fbbf24',
-                weight: 2,
-                fillOpacity: 0.9,
-            }),
+            style: getGeoJsonFeatureStyle,
+            pointToLayer: (feature, latlng) => createPointOfInterestMarker(feature, latlng),
+            onEachFeature: (feature, layer) => decorateGeoJsonLayer(feature, layer),
         });
         geoJsonLayer.addTo(map);
         const bounds = geoJsonLayer.getBounds();
@@ -29136,11 +29909,10 @@ function appendOngoingToolCallCount(label, count) {
  * Builds the label for an ongoing tool call group.
  */
 function buildOngoingToolCallLabel(group) {
-    const baseLabel = group.displayTitle || `Executing ${group.toolCall.name}`;
-    return appendOngoingToolCallCount(baseLabel, group.count);
+    return appendOngoingToolCallCount(group.label, group.count);
 }
 /**
- * Extracts the assistant preparation phase for grouping, when present.
+ * Extracts the assistant preparation phase from one tool call, when present.
  */
 function getOngoingToolCallPreparationPhase(toolCall) {
     if (!isAssistantPreparationToolCall(toolCall)) {
@@ -29149,6 +29921,21 @@ function getOngoingToolCallPreparationPhase(toolCall) {
     const toolArguments = parseToolCallArguments(toolCall);
     return typeof toolArguments.phase === 'string' ? toolArguments.phase : undefined;
 }
+/**
+ * Resolves shared chip text for one tool call.
+ *
+ * This helper is intentionally reused for both ongoing and completed tool-call chips.
+ */
+function resolveToolCallChipLabel(toolCall, options = {}) {
+    const { chipletInfo } = options;
+    const preparationPhase = getOngoingToolCallPreparationPhase(toolCall);
+    if (preparationPhase) {
+        const toolInfo = TOOL_TITLES[toolCall.name];
+        const preparationTitle = (toolInfo === null || toolInfo === void 0 ? void 0 : toolInfo.title) || toolCall.name;
+        return `${preparationTitle}: ${preparationPhase}`;
+    }
+    return buildToolCallChipText(chipletInfo || getToolCallChipletInfo(toolCall));
+}
 /**
  * Builds a stable participant identity for ongoing tool call grouping.
  */
@@ -29183,15 +29970,17 @@ function dedupeToolCalls(toolCalls) {
 /**
  * Groups ongoing tool calls by tool identity to avoid duplicate chips.
  */
-function groupOngoingToolCalls(toolCalls, toolTitles, teammates) {
+function groupOngoingToolCalls(toolCalls, teammates) {
     if (!toolCalls || toolCalls.length === 0) {
         return [];
     }
     const grouped = new Map();
     const ordered = [];
     for (const toolCall of toolCalls) {
+        const chipletInfo = getToolCallChipletInfo(toolCall);
+        const label = resolveToolCallChipLabel(toolCall, { chipletInfo });
         const preparationPhase = getOngoingToolCallPreparationPhase(toolCall);
-        const teamAgentData = resolveTeamAgentChipData(toolCall, teammates);
+        const teamAgentData = resolveTeamAgentChipData(toolCall, teammates, chipletInfo);
         const participantKey = getOngoingToolCallParticipantKey(teamAgentData);
         const groupKey = getOngoingToolCallGroupKey(toolCall, {
             preparationPhase,
@@ -29202,17 +29991,11 @@ function groupOngoingToolCalls(toolCalls, toolTitles, teammates) {
             existing.count += 1;
             continue;
         }
-        const toolInfo = TOOL_TITLES[toolCall.name];
-        const isTeamTool = isTeamToolName(toolCall.name);
-        const toolTitle = (toolTitles === null || toolTitles === void 0 ? void 0 : toolTitles[toolCall.name]) || (toolInfo === null || toolInfo === void 0 ? void 0 : toolInfo.title) || (isTeamTool ? 'Consulting teammate' : undefined);
-        const displayTitle = preparationPhase ? `${toolTitle || toolCall.name}: ${preparationPhase}` : toolTitle;
-        const emoji = isTeamTool ? '??' : (toolInfo === null || toolInfo === void 0 ? void 0 : toolInfo.emoji) || '???';
         const group = {
             key: groupKey,
             toolCall,
             count: 1,
-            displayTitle,
-            emoji,
+            label,
             teamAgentData,
         };
         grouped.set(groupKey, group);
@@ -29230,7 +30013,7 @@ const ChatMessageItem = memo(
 //                                          Or make normal function from this?
 (props) => {
     var _a, _b;
-    const { message, participant, participants, isLastMessage, onMessage, setExpandedMessageId, isExpanded, currentRating, handleRating, mode, isCopyButtonEnabled, isFeedbackEnabled, onCopy, onCreateAgent, toolTitles, teammates, onToolCallClick, onCitationClick, soundSystem, } = props;
+    const { message, participant, participants, isLastMessage, onMessage, setExpandedMessageId, isExpanded, currentRating, handleRating, mode, isCopyButtonEnabled, isFeedbackEnabled, onCopy, onCreateAgent, teammates, onToolCallClick, onCitationClick, soundSystem, isSpeechPlaybackEnabled, } = props;
     const { isComplete = true,
     // <- TODO: Destruct all `messages` properties like `isComplete`
      } = message;
@@ -29332,15 +30115,16 @@ const ChatMessageItem = memo(
     const [isAudioLoading, setIsAudioLoading] = useState(false);
     const [isAudioPlaying, setIsAudioPlaying] = useState(false);
     const [audioError, setAudioError] = useState(null);
-    const ongoingToolCallGroups = useMemo(() => groupOngoingToolCalls(message.ongoingToolCalls, toolTitles, teammates), [message.ongoingToolCalls, toolTitles, teammates]);
+    const ongoingToolCallGroups = useMemo(() => groupOngoingToolCalls(message.ongoingToolCalls, teammates), [message.ongoingToolCalls, teammates]);
     const completedToolCallCount = (_b = completedToolCalls === null || completedToolCalls === void 0 ? void 0 : completedToolCalls.length) !== null && _b !== void 0 ? _b : 0;
     const transitiveToolCallCount = transitiveToolCalls.length;
     const ongoingToolCallCount = ongoingToolCallGroups.length;
     const toolCallChipCount = completedToolCallCount + transitiveToolCallCount + ongoingToolCallCount;
     const shouldShowButtons = isLastMessage && buttons.length > 0 && onMessage;
-    const playButtonTitle = audioError !== null && audioError !== void 0 ? audioError : (isAudioPlaying ? 'Pause message playback' : 'Read message aloud');
     const trimmedMessageContent = message.content.trim();
-    const shouldShowPlayButton = trimmedMessageContent.length > 0;
+    const speechPlaybackEnabled = isSpeechPlaybackEnabled !== null && isSpeechPlaybackEnabled !== void 0 ? isSpeechPlaybackEnabled : true;
+    const shouldShowPlayButton = speechPlaybackEnabled && trimmedMessageContent.length > 0;
+    const playButtonTitle = audioError !== null && audioError !== void 0 ? audioError : (isAudioPlaying ? 'Pause message playback' : 'Read message aloud');
     /**
      * Attaches playback listeners to keep the UI in sync with the audio element.
      *
@@ -29566,7 +30350,7 @@ const ChatMessageItem = memo(
                                     return null;
                                 }) })), message.attachments && message.attachments.length > 0 && (jsx("div", { className: styles$5.attachments, children: message.attachments.map((attachment, index) => (jsxs("a", { href: attachment.url, target: "_blank", rel: "noopener noreferrer", className: styles$5.attachment, title: attachment.name, children: [jsx("span", { className: styles$5.attachmentIcon, children: "\uD83D\uDCCE" }), jsx("span", { className: styles$5.attachmentName, children: attachment.name })] }, index))) })), completedToolCalls && completedToolCalls.length > 0 && (jsxs("div", { className: styles$5.completedToolCalls, children: [completedToolCalls.map((toolCall, index) => {
                                         const chipletInfo = getToolCallChipletInfo(toolCall);
-                                        const chipletText = buildToolCallChipText(chipletInfo);
+                                        const chipletText = resolveToolCallChipLabel(toolCall, { chipletInfo });
                                         const teamAgentData = resolveTeamAgentChipData(toolCall, teammates, chipletInfo);
                                         // If this is a team tool with agent data, use AgentChip
                                         if (teamAgentData) {
@@ -29587,7 +30371,9 @@ const ChatMessageItem = memo(
                                             }, children: chipletText }, index));
                                     }), transitiveToolCalls.map((toolCallEntry, index) => {
                                         const chipletInfo = getToolCallChipletInfo(toolCallEntry.toolCall);
-                                        const chipletText = buildToolCallChipText(chipletInfo);
+                                        const chipletText = resolveToolCallChipLabel(toolCallEntry.toolCall, {
+                                            chipletInfo,
+                                        });
                                         return (jsxs("button", { className: styles$5.completedToolCall, onClick: (event) => {
                                                 event.stopPropagation();
                                                 if (onToolCallClick) {
@@ -29600,7 +30386,7 @@ const ChatMessageItem = memo(
                                         return (jsx(AgentChip, { agent: group.teamAgentData, isOngoing: true, labelSuffix: labelSuffix }, group.key));
                                     }
                                     const label = buildOngoingToolCallLabel(group);
-                                    return (jsxs("div", { className: styles$5.ongoingToolCall, children: [jsx("div", { className: styles$5.ongoingToolCallSpinner }), jsx("span", { className: styles$5.ongoingToolCallName, children: `${group.emoji} ${label}...` })] }, group.key));
+                                    return (jsxs("div", { className: styles$5.ongoingToolCall, children: [jsx("div", { className: styles$5.ongoingToolCallSpinner }), jsx("span", { className: styles$5.ongoingToolCallName, children: `${label}...` })] }, group.key));
                                 }) })), shouldShowButtons && (jsx("div", { className: styles$5.messageButtons, children: buttons.map((button, buttonIndex) => (jsx("button", { className: styles$5.messageButton, onClick: (event) => {
                                         event.stopPropagation();
                                         if (onMessage) {
@@ -29697,7 +30483,7 @@ ChatMessageItem.displayName = 'ChatMessageItem';
  * @private component of `<Chat/>`
  */
 function ChatMessageList(props) {
-    const { messages, participants, expandedMessageId, messageRatings, setExpandedMessageId, handleRating, mode, isCopyButtonEnabled, isFeedbackEnabled, onCopy, onMessage, onCreateAgent, toolTitles, teammates, onToolCallClick, onCitationClick, soundSystem, setChatMessagesElement, onScroll, chatMessagesClassName, hasActions, } = props;
+    const { messages, participants, expandedMessageId, messageRatings, setExpandedMessageId, handleRating, mode, isCopyButtonEnabled, isFeedbackEnabled, onCopy, onMessage, onCreateAgent, toolTitles, teammates, onToolCallClick, onCitationClick, soundSystem, isSpeechPlaybackEnabled, setChatMessagesElement, onScroll, chatMessagesClassName, hasActions, } = props;
     const firstMessage = messages[0];
     const firstMsgContent = (firstMessage === null || firstMessage === void 0 ? void 0 : firstMessage.content) || '';
     const firstMsgLines = firstMsgContent.split(/\r?\n/).length;
@@ -29709,7 +30495,7 @@ function ChatMessageList(props) {
                 const isLastMessage = index === messages.length - 1;
                 const isExpanded = expandedMessageId === message.id;
                 const currentRating = messageRatings.get(message.id || message.content /* <-[??] */) || 0;
-                return (jsx(ChatMessageItem, { message: message, participant: participant, participants: participants, isLastMessage: isLastMessage, onMessage: onMessage, setExpandedMessageId: setExpandedMessageId, isExpanded: isExpanded, currentRating: currentRating, handleRating: handleRating, mode: mode, isCopyButtonEnabled: isCopyButtonEnabled, isFeedbackEnabled: isFeedbackEnabled, onCopy: onCopy, onCreateAgent: onCreateAgent, toolTitles: toolTitles, teammates: teammates, onToolCallClick: onToolCallClick, onCitationClick: onCitationClick, soundSystem: soundSystem }, message.id));
+                return (jsx(ChatMessageItem, { message: message, participant: participant, participants: participants, isLastMessage: isLastMessage, onMessage: onMessage, setExpandedMessageId: setExpandedMessageId, isExpanded: isExpanded, currentRating: currentRating, handleRating: handleRating, mode: mode, isCopyButtonEnabled: isCopyButtonEnabled, isFeedbackEnabled: isFeedbackEnabled, onCopy: onCopy, onCreateAgent: onCreateAgent, toolTitles: toolTitles, teammates: teammates, onToolCallClick: onToolCallClick, onCitationClick: onCitationClick, soundSystem: soundSystem, isSpeechPlaybackEnabled: isSpeechPlaybackEnabled }, message.id));
             }), jsx("div", { style: { height: 100 } })] }));
 }
 
@@ -30913,7 +31699,7 @@ function isLatestMessageVisible(chatMessagesElement, messageSelector) {
  * @public exported from `@promptbook/components`
  */
 function Chat(props) {
-    const { title = 'Chat', messages, onChange, onMessage, onReset, onFeedback, onFileUpload, speechRecognition, placeholderMessageContent, defaultMessage, children, className, style, isAiTextHumanizedAndPromptbookified = true, isVoiceCalling = false, isFocusedOnLoad, participants = [], extraActions, actionsContainer, saveFormats, isSaveButtonEnabled = true, isCopyButtonEnabled = true, buttonColor: buttonColorRaw, onUseTemplate, onCreateAgent, toolTitles, teammates, visual, effectConfigs, soundSystem, speechRecognitionLanguage, } = props;
+    const { title = 'Chat', messages, onChange, onMessage, onReset, onFeedback, onFileUpload, speechRecognition, placeholderMessageContent, defaultMessage, children, className, style, isAiTextHumanizedAndPromptbookified = true, isVoiceCalling = false, isFocusedOnLoad, participants = [], extraActions, actionsContainer, saveFormats, isSaveButtonEnabled = true, isCopyButtonEnabled = true, buttonColor: buttonColorRaw, onUseTemplate, onCreateAgent, toolTitles, teammates, visual, effectConfigs, soundSystem, speechRecognitionLanguage, isSpeechPlaybackEnabled = true, } = props;
     const buttonColor = useMemo(() => Color.from(buttonColorRaw || '#0066cc'), [buttonColorRaw]);
     const agentParticipant = useMemo(() => participants.find((participant) => participant.name === 'AGENT'), [participants]);
     const postprocessedMessages = useMemo(() => {
@@ -31087,7 +31873,7 @@ function Chat(props) {
                             }, onCitationClick: (citation) => {
                                 setSelectedCitation(citation);
                                 setCitationModalOpen(true);
-                            }, setChatMessagesElement: setChatMessagesElement, onScroll: handleChatScroll, chatMessagesClassName: useChatCssClassName('chatMessages'), hasActions: hasActions }), onMessage && (jsx(ChatInputArea, { onMessage: onMessage, onChange: onChange, onFileUpload: onFileUpload, speechRecognition: speechRecognition, speechRecognitionLanguage: speechRecognitionLanguage, defaultMessage: defaultMessage, placeholderMessageContent: placeholderMessageContent, isFocusedOnLoad: isFocusedOnLoad, isMobile: isMobileFromHook, isVoiceCalling: isVoiceCalling, participants: participants, buttonColor: buttonColor, soundSystem: soundSystem, onButtonClick: handleButtonClick, chatInputClassName: useChatCssClassName('chatInput') }))] }) }), jsx(ChatToolCallModal, { isOpen: toolCallModalOpen, toolCall: selectedToolCall, onClose: () => setToolCallModalOpen(false), toolTitles: toolTitles, agentParticipant: agentParticipant, buttonColor: buttonColor }), jsx(ChatCitationModal, { isOpen: citationModalOpen, citation: selectedCitation, participants: participants, soundSystem: soundSystem, onClose: () => setCitationModalOpen(false) }), jsx(ChatRatingModal, { isOpen: ratingModalOpen, selectedMessage: selectedMessage, postprocessedMessages: postprocessedMessages, messages: messages, hoveredRating: hoveredRating, messageRatings: messageRatings, textRating: textRating, mode: mode, isMobile: isMobileFromHook, onClose: () => setRatingModalOpen(false), setHoveredRating: setHoveredRating, setMessageRatings: setMessageRatings, setSelectedMessage: setSelectedMessage, setTextRating: setTextRating, submitRating: submitRating })] }));
+                            }, setChatMessagesElement: setChatMessagesElement, onScroll: handleChatScroll, isSpeechPlaybackEnabled: isSpeechPlaybackEnabled, chatMessagesClassName: useChatCssClassName('chatMessages'), hasActions: hasActions }), onMessage && (jsx(ChatInputArea, { onMessage: onMessage, onChange: onChange, onFileUpload: onFileUpload, speechRecognition: speechRecognition, speechRecognitionLanguage: speechRecognitionLanguage, defaultMessage: defaultMessage, placeholderMessageContent: placeholderMessageContent, isFocusedOnLoad: isFocusedOnLoad, isMobile: isMobileFromHook, isVoiceCalling: isVoiceCalling, participants: participants, buttonColor: buttonColor, soundSystem: soundSystem, onButtonClick: handleButtonClick, chatInputClassName: useChatCssClassName('chatInput') }))] }) }), jsx(ChatToolCallModal, { isOpen: toolCallModalOpen, toolCall: selectedToolCall, onClose: () => setToolCallModalOpen(false), toolTitles: toolTitles, agentParticipant: agentParticipant, buttonColor: buttonColor }), jsx(ChatCitationModal, { isOpen: citationModalOpen, citation: selectedCitation, participants: participants, soundSystem: soundSystem, onClose: () => setCitationModalOpen(false) }), jsx(ChatRatingModal, { isOpen: ratingModalOpen, selectedMessage: selectedMessage, postprocessedMessages: postprocessedMessages, messages: messages, hoveredRating: hoveredRating, messageRatings: messageRatings, textRating: textRating, mode: mode, isMobile: isMobileFromHook, onClose: () => setRatingModalOpen(false), setHoveredRating: setHoveredRating, setMessageRatings: setMessageRatings, setSelectedMessage: setSelectedMessage, setTextRating: setTextRating, submitRating: submitRating })] }));
 }
 
 /**
@@ -31235,6 +32021,23 @@ function getRandomThinkingVariant(variants, excludeVariant) {
     }
     return candidates[Math.floor(Math.random() * candidates.length)];
 }
+/**
+ * Converts unknown prompt parameter values to string values required by prompt templates.
+ */
+function normalizePromptParameters(parameters) {
+    const normalizedEntries = [];
+    for (const [key, value] of Object.entries(parameters)) {
+        if (value === undefined || value === null) {
+            continue;
+        }
+        if (typeof value === 'string') {
+            normalizedEntries.push([key, value]);
+            continue;
+        }
+        normalizedEntries.push([key, JSON.stringify(value)]);
+    }
+    return Object.fromEntries(normalizedEntries);
+}
 /**
  * LlmChat component that provides chat functionality with LLM integration
  *
@@ -31248,7 +32051,8 @@ function getRandomThinkingVariant(variants, excludeVariant) {
  * @public exported from `@promptbook/components`
  */
 function LlmChat(props) {
-    const { llmTools, persistenceKey, onChange, onReset, onError, initialMessages, sendMessage, userParticipantName = 'USER', llmParticipantName = 'ASSISTANT', autoExecuteMessage, buttonColor, toolTitles, thinkingMessages, chatFailMessage, ...restProps } = props;
+    const { llmTools, persistenceKey, onChange, onReset, onError, initialMessages, sendMessage, userParticipantName = 'USER', llmParticipantName = 'ASSISTANT', autoExecuteMessage, buttonColor, toolTitles, thinkingMessages, promptParameters, chatFailMessage, resetMode = 'reset-current', ...restProps } = props;
+    const resolvedPromptParameters = useMemo(() => normalizePromptParameters(promptParameters !== null && promptParameters !== void 0 ? promptParameters : {}), [promptParameters]);
     const resolvedChatFailMessage = chatFailMessage || DEFAULT_CHAT_FAIL_MESSAGE;
     // Internal state management
     // DRY: Single factory for seeding initial messages (used on mount and after reset)
@@ -31424,7 +32228,7 @@ function LlmChat(props) {
             const prompt = {
                 title: 'User Message',
                 content: messageContent,
-                parameters: {},
+                parameters: resolvedPromptParameters,
                 modelRequirements: {
                     modelVariant: 'CHAT',
                 },
@@ -31514,9 +32318,22 @@ function LlmChat(props) {
         finally {
             requestInFlightRef.current = false;
         }
-    }, [messages, llmTools, props.thread, onError, llmParticipantName, userParticipantName, thinkingVariants]);
+    }, [
+        messages,
+        llmTools,
+        props.thread,
+        resolvedPromptParameters,
+        onError,
+        llmParticipantName,
+        userParticipantName,
+        thinkingVariants,
+    ]);
     // Handle chat reset
     const handleReset = useCallback(async () => {
+        if (resetMode === 'delegate' && onReset) {
+            await onReset();
+            return;
+        }
         // Re-seed with initialMessages instead of empty array
         setMessages(buildInitialMessages());
         setTasksProgress([]);
@@ -31531,7 +32348,7 @@ function LlmChat(props) {
         if (onReset) {
             await onReset();
         }
-    }, [persistenceKey, onReset, buildInitialMessages]);
+    }, [buildInitialMessages, onReset, persistenceKey, resetMode]);
     // Handle retry of last failed message
     const handleRetry = useCallback(() => {
         if (lastFailedMessage) {