@promptbook/components 0.111.0-4 → 0.111.0-7

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('react/jsx-runtime'), require('react'), require('spacetrim'), require('crypto-js'), require('crypto-js/enc-hex'), require('path'), require('crypto'), require('moment'), require('react-dom'), require('@monaco-editor/react'), require('monaco-editor'), require('destroyable'), require('katex'), require('react-dom/client'), require('showdown'), require('rxjs'), require('jspdf'), require('lucide-react'), require('waitasecond'), require('crypto-js/sha256'), require('mime-types'), require('papaparse'), require('colors'), require('@openai/agents'), require('bottleneck'), require('openai'), require('leaflet/dist/leaflet.css'), require('leaflet'), require('qrcode')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'react/jsx-runtime', 'react', 'spacetrim', 'crypto-js', 'crypto-js/enc-hex', 'path', 'crypto', 'moment', 'react-dom', '@monaco-editor/react', 'monaco-editor', 'destroyable', 'katex', 'react-dom/client', 'showdown', 'rxjs', 'jspdf', 'lucide-react', 'waitasecond', 'crypto-js/sha256', 'mime-types', 'papaparse', 'colors', '@openai/agents', 'bottleneck', 'openai', 'leaflet/dist/leaflet.css', 'leaflet', 'qrcode'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-components"] = {}, global.jsxRuntime, global.react, global.spaceTrim$1, global.cryptoJs, global.hexEncoder, global.path, global.crypto$1, global.moment, global.reactDom, global.Editor, global.monacoEditor, global.destroyable, global.katex, global.client, global.showdown, global.rxjs, global.jspdf, global.lucideReact, global.waitasecond, global.sha256, global.mimeTypes, global.papaparse, global.colors, global.agents, global.Bottleneck, global.OpenAI, null, global.L, global.QRCode));
-})(this, (function (exports, jsxRuntime, react, spaceTrim$1, cryptoJs, hexEncoder, path, crypto$1, moment, reactDom, Editor, monacoEditor, destroyable, katex, client, showdown, rxjs, jspdf, lucideReact, waitasecond, sha256, mimeTypes, papaparse, colors, agents, Bottleneck, OpenAI, leaflet_css, L, QRCode) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('react/jsx-runtime'), require('react'), require('spacetrim'), require('crypto-js'), require('crypto-js/enc-hex'), require('path'), require('crypto'), require('moment'), require('react-dom'), require('@monaco-editor/react'), require('destroyable'), require('katex'), require('react-dom/client'), require('showdown'), require('rxjs'), require('jspdf'), require('lucide-react'), require('waitasecond'), require('crypto-js/sha256'), require('mime-types'), require('papaparse'), require('colors'), require('@openai/agents'), require('bottleneck'), require('openai'), require('leaflet/dist/leaflet.css'), require('leaflet'), require('qrcode')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'react/jsx-runtime', 'react', 'spacetrim', 'crypto-js', 'crypto-js/enc-hex', 'path', 'crypto', 'moment', 'react-dom', '@monaco-editor/react', 'destroyable', 'katex', 'react-dom/client', 'showdown', 'rxjs', 'jspdf', 'lucide-react', 'waitasecond', 'crypto-js/sha256', 'mime-types', 'papaparse', 'colors', '@openai/agents', 'bottleneck', 'openai', 'leaflet/dist/leaflet.css', 'leaflet', 'qrcode'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-components"] = {}, global.jsxRuntime, global.react, global.spaceTrim$1, global.cryptoJs, global.hexEncoder, global.path, global.crypto$1, global.moment, global.reactDom, global.Editor, global.destroyable, global.katex, global.client, global.showdown, global.rxjs, global.jspdf, global.lucideReact, global.waitasecond, global.sha256, global.mimeTypes, global.papaparse, global.colors, global.agents, global.Bottleneck, global.OpenAI, null, global.L, global.QRCode));
+})(this, (function (exports, jsxRuntime, react, spaceTrim$1, cryptoJs, hexEncoder, path, crypto$1, moment, reactDom, Editor, destroyable, katex, client, showdown, rxjs, jspdf, lucideReact, waitasecond, sha256, mimeTypes, papaparse, colors, agents, Bottleneck, OpenAI, leaflet_css, L, QRCode) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -32,7 +32,7 @@
      * @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
@@ -516,6 +516,188 @@
         }
     }
 
+    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
      *
@@ -596,29 +778,24 @@
          * @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}".`);
             }
         }
         /**
@@ -649,73 +826,8 @@
          * @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
@@ -724,52 +836,8 @@
          * @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
@@ -778,25 +846,8 @@
          * @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
@@ -805,39 +856,8 @@
          * @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
@@ -959,14 +979,16 @@
         }
         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() {
@@ -981,22 +1003,6 @@
             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
@@ -1988,6 +1994,12 @@
             // <- 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
      *
@@ -3086,13 +3098,29 @@
         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 {
@@ -3104,59 +3132,35 @@
     }
     /**
      * 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() === '') {
@@ -3165,10 +3169,11 @@
         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
@@ -3177,17 +3182,32 @@
         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';
@@ -3203,6 +3223,7 @@
      * Converts a positive integer into a Roman numeral string.
      *
      * @param value Positive integer value.
+     * @private function of ParameterNaming
      */
     function toRomanNumeral(value) {
         const romanTable = [
@@ -3231,24 +3252,28 @@
         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 },
@@ -3261,6 +3286,7 @@
      * 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();
@@ -3277,9 +3303,10 @@
         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;
@@ -3296,28 +3323,40 @@
         }
         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
@@ -3332,6 +3371,55 @@
             - 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
      *
@@ -3349,24 +3437,24 @@
         if (values.length === 0) {
             return new PromptString(spaceTrim__default["default"](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,
@@ -3386,7 +3474,7 @@
             const parameterName = parameterNamesOrdered[i];
             return parameterName === undefined
                 ? `${result}${stringsItem}`
-                : `${result}${stringsItem}${formatParameterPlaceholder(parameterName)}`;
+                : `${result}${stringsItem}${ParameterSection.formatParameterPlaceholder(parameterName)}`;
         }, '');
         pipelineString = spaceTrim__default["default"](pipelineString);
         try {
@@ -3404,14 +3492,16 @@
                   
                 `));
         }
-        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);
@@ -3421,7 +3511,7 @@
                 value: entry.stringValue,
                 jsonValue: entry.jsonValue,
             }));
-            pipelineString = `${pipelineString}\n\n${buildParametersSection(parameterItems)}`;
+            pipelineString = `${pipelineString}\n\n${ParameterSection.buildParametersSection(parameterItems)}`;
         }
         return new PromptString(pipelineString);
     }
@@ -7085,6 +7175,7 @@
             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,
         };
     }
     /**
@@ -7130,12 +7221,15 @@
      * @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),
             };
         }
         {
@@ -7859,71 +7953,137 @@
     }
 
     /**
-     * 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.spaceTrim(`
-            # 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.spaceTrim(`
+            # 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
 
@@ -8099,6 +8259,76 @@
      * 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.spaceTrim(`
+            # 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
      *
@@ -10996,75 +11226,290 @@
      */
 
     /**
-     * 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.spaceTrim(`
-            # ${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.spaceTrim(`
+                          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.spaceTrim((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.spaceTrim(`
+            # ${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
      *
@@ -11101,6 +11546,7 @@
         new MetaColorCommitmentDefinition(),
         new MetaFontCommitmentDefinition(),
         new MetaLinkCommitmentDefinition(),
+        new MetaDisclaimerCommitmentDefinition(),
         new MetaCommitmentDefinition(),
         new NoteCommitmentDefinition('NOTE'),
         new NoteCommitmentDefinition('NOTES'),
@@ -11112,6 +11558,7 @@
         new InitialMessageCommitmentDefinition(),
         new UserMessageCommitmentDefinition(),
         new AgentMessageCommitmentDefinition(),
+        new MessageSuffixCommitmentDefinition(),
         new MessageCommitmentDefinition('MESSAGE'),
         new MessageCommitmentDefinition('MESSAGES'),
         new ScenarioCommitmentDefinition('SCENARIO'),
@@ -11127,6 +11574,7 @@
         new UseBrowserCommitmentDefinition(),
         new UseSearchEngineCommitmentDefinition(),
         new UseTimeCommitmentDefinition(),
+        new UseUserLocationCommitmentDefinition(),
         new UseEmailCommitmentDefinition(),
         new UseImageGeneratorCommitmentDefinition('USE IMAGE GENERATOR'),
         new UseMcpCommitmentDefinition(),
@@ -11478,6 +11926,14 @@
                 });
                 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',
@@ -11612,6 +12068,14 @@
                 meta.description = spaceTrim__default["default"](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;
@@ -11818,73 +12282,6 @@
     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.
      *
@@ -12918,122 +13315,164 @@
                     }, children: jsxRuntime.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 = react.useRef([]);
+        const codeBlockDecorationIdsRef = react.useRef([]);
+        react.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 monacoEditor.MarkerSeverity.Warning;
+            return monaco.MarkerSeverity.Warning;
         }
         if (severity === 'info') {
-            return monacoEditor.MarkerSeverity.Info;
+            return monaco.MarkerSeverity.Info;
         }
         if (severity === 'hint') {
-            return monacoEditor.MarkerSeverity.Hint;
-        }
-        return monacoEditor.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 }) {
+        react.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();
@@ -13044,9 +13483,6 @@
         }
         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) {
@@ -13062,9 +13498,6 @@
         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;
@@ -13096,138 +13529,414 @@
         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] = react.useState(false);
-        const [editor, setEditor] = react.useState(null);
-        const [isFocused, setIsFocused] = react.useState(false);
-        const [isTouchDevice, setIsTouchDevice] = react.useState(false);
-        const [isSavedShown, setIsSavedShown] = react.useState(false);
-        const [uploadItems, setUploadItemsState] = react.useState([]);
-        const monaco = Editor.useMonaco();
-        // stable unique id for this instance
-        const instanceIdRef = react.useRef(++notebookStyleCounter);
-        const instanceClass = `book-editor-instance-${instanceIdRef.current}`;
-        // [1] Track touch start position to differentiate tap from drag
-        const touchStartRef = react.useRef(null);
-        const fileUploadInputRef = react.useRef(null);
-        const cameraInputRef = react.useRef(null);
-        const uploadItemsRef = react.useRef([]);
-        const uploadFilesRef = react.useRef(new Map());
-        const uploadDecorationIdsRef = react.useRef(new Map());
-        const uploadControllersRef = react.useRef(new Map());
-        const uploadQueueTimerRef = react.useRef(null);
-        const editorUpdateTimerRef = react.useRef(null);
-        const progressUpdateTimerRef = react.useRef(null);
-        const pendingReplacementsRef = react.useRef([]);
-        const pendingProgressUpdatesRef = react.useRef(new Map());
-        const processUploadQueueRef = react.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);
-          
-        useEffect(() => {
-            if (!monaco || !editor || !sync) {
+    function useBookEditorMonacoLanguage({ monaco }) {
+        react.useEffect(() => {
+            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, }) {
         react.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 = react.useCallback((updater) => {
-            const next = updater(uploadItemsRef.current);
-            uploadItemsRef.current = next;
-            setUploadItemsState(next);
-        }, []);
-        /**
-         * Batches upload progress updates to reduce render churn.
-         */
-        const queueProgressUpdate = react.useCallback((uploadId, progress, loadedBytes, totalBytes) => {
-            pendingProgressUpdatesRef.current.set(uploadId, {
-                progress,
-                loadedBytes,
-                totalBytes,
-            });
-            if (progressUpdateTimerRef.current !== null) {
-                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);
             }
-            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 = react.useCallback(() => {
-            if (!editor) {
-                return;
+            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;
             }
-            const model = editor.getModel();
+            .${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] = react.useState([]);
+        const uploadItemsRef = react.useRef([]);
+        const uploadFilesRef = react.useRef(new Map());
+        const uploadDecorationIdsRef = react.useRef(new Map());
+        const uploadControllersRef = react.useRef(new Map());
+        const uploadQueueTimerRef = react.useRef(null);
+        const editorUpdateTimerRef = react.useRef(null);
+        const progressUpdateTimerRef = react.useRef(null);
+        const pendingReplacementsRef = react.useRef([]);
+        const pendingProgressUpdatesRef = react.useRef(new Map());
+        const processUploadQueueRef = react.useRef(() => undefined);
+        const setUploadItems = react.useCallback((updater) => {
+            const next = updater(uploadItemsRef.current);
+            uploadItemsRef.current = next;
+            setUploadItemsState(next);
+        }, []);
+        const queueProgressUpdate = react.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 = react.useCallback(() => {
+            if (!editor) {
+                return;
+            }
+            const model = editor.getModel();
             if (!model) {
                 return;
             }
@@ -13256,9 +13965,6 @@
                 editor.deltaDecorations(decorationsToRemove, []);
             }
         }, [editor]);
-        /**
-         * Queues a placeholder replacement and debounces editor updates.
-         */
         const queueEditorReplacement = react.useCallback((uploadId, replacementText) => {
             const decorationId = uploadDecorationIdsRef.current.get(uploadId);
             if (!decorationId) {
@@ -13282,11 +13988,8 @@
             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 = react.useCallback(() => {
             if (uploadQueueTimerRef.current !== null) {
                 return;
@@ -13296,9 +13999,6 @@
                 processUploadQueueRef.current();
             }, 0);
         }, []);
-        /**
-         * Starts uploading a queued item.
-         */
         const startUpload = react.useCallback(async (uploadId) => {
             if (!onFileUpload) {
                 return;
@@ -13373,9 +14073,6 @@
                 queueUploadProcessing();
             }
         }, [onFileUpload, queueEditorReplacement, queueProgressUpdate, queueUploadProcessing, setUploadItems]);
-        /**
-         * Starts queued uploads up to the concurrency limit.
-         */
         const processUploadQueue = react.useCallback(() => {
             if (!onFileUpload) {
                 return;
@@ -13392,9 +14089,6 @@
             });
         }, [onFileUpload, startUpload]);
         processUploadQueueRef.current = processUploadQueue;
-        /**
-         * Pauses a queued or active upload.
-         */
         const pauseUpload = react.useCallback((uploadId) => {
             setUploadItems((items) => items.map((item) => item.id === uploadId && item.status === 'queued'
                 ? {
@@ -13405,9 +14099,6 @@
             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 = react.useCallback((uploadId) => {
             setUploadItems((items) => items.map((item) => item.id === uploadId
                 ? {
@@ -13422,43 +14113,6 @@
                 : item));
             queueUploadProcessing();
         }, [queueUploadProcessing, setUploadItems]);
-        react.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]);
-        react.useEffect(() => {
-            if (!isSavedShown) {
-                return;
-            }
-            const timer = setTimeout(() => {
-                setIsSavedShown(false);
-            }, 2000);
-            return () => {
-                clearTimeout(timer);
-            };
-        }, [isSavedShown]);
         react.useEffect(() => {
             return () => {
                 if (uploadQueueTimerRef.current !== null) {
@@ -13488,380 +14142,242 @@
                 uploadFilesRef.current.clear();
                 uploadDecorationIdsRef.current.clear();
                 setUploadItems(() => []);
-            }, 1500);
+            }, COMPLETED_UPLOADS_CLEAR_DELAY_MS);
             return () => {
                 clearTimeout(timer);
             };
-        }, [setUploadItems, uploadItems]);
-        react.useEffect(() => {
-            if (!monaco) {
+        }, [uploadItems]);
+        const handleFiles = react.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]);
-        react.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 = react.useRef([]);
-        const codeBlockDecorationIdsRef = react.useRef([]);
-        react.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]);
-        react.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 = react.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 = react.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 (jsxRuntime.jsxs("div", { className: styles$d.uploadPanel, role: "status", "aria-live": "polite", children: [jsxRuntime.jsxs("div", { className: styles$d.uploadPanelHeader, children: [jsxRuntime.jsx("div", { className: styles$d.uploadPanelTitle, children: "Uploads" }), jsxRuntime.jsxs("div", { className: styles$d.uploadPanelHeaderMeta, children: [uploadStats.uploadingFiles + uploadStats.queuedFiles, " active / ", uploadStats.totalFiles, " total"] })] }), jsxRuntime.jsxs("div", { className: styles$d.uploadPanelSummary, children: [jsxRuntime.jsxs("div", { children: ["Files: ", uploadStats.totalFiles, " total, ", uploadStats.completedFiles, " done"] }), jsxRuntime.jsxs("div", { children: ["Data: ", BookEditorMonacoFormatting.formatBytes(uploadStats.uploadedBytes), " /", ' ', BookEditorMonacoFormatting.formatBytes(uploadStats.totalBytes)] }), jsxRuntime.jsxs("div", { children: ["Speed:", ' ', uploadStats.speedBytesPerSecond > 0
+                                    ? `${BookEditorMonacoFormatting.formatBytes(uploadStats.speedBytesPerSecond)}/s`
+                                    : '--'] }), jsxRuntime.jsxs("div", { children: ["Elapsed: ", BookEditorMonacoFormatting.formatDuration(uploadStats.elapsedMs)] }), jsxRuntime.jsxs("div", { children: ["Paused: ", uploadStats.pausedFiles, ", Failed: ", uploadStats.failedFiles] })] }), jsxRuntime.jsx("div", { className: styles$d.uploadPanelProgressBar, children: jsxRuntime.jsx("div", { className: styles$d.uploadPanelProgressFill, style: { width: `${Math.round(uploadStats.progress * 100)}%` } }) }), jsxRuntime.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 (jsxRuntime.jsxs("div", { className: styles$d.uploadRow, children: [jsxRuntime.jsxs("div", { className: styles$d.uploadRowHeader, children: [jsxRuntime.jsx("div", { className: styles$d.uploadRowName, title: item.fileName, children: item.fileName }), jsxRuntime.jsx("div", { className: styles$d.uploadRowStatus, children: UPLOAD_STATUS_LABELS[item.status] })] }), jsxRuntime.jsxs("div", { className: styles$d.uploadRowMeta, children: [jsxRuntime.jsxs("span", { children: [BookEditorMonacoFormatting.formatBytes(item.loadedBytes), " /", ' ', BookEditorMonacoFormatting.formatBytes(item.totalBytes)] }), jsxRuntime.jsxs("span", { children: [percent, "%"] })] }), jsxRuntime.jsx("div", { className: styles$d.uploadRowProgressBar, children: jsxRuntime.jsx("div", { className: styles$d.uploadRowProgressFill, style: { width: `${percent}%` } }) }), jsxRuntime.jsxs("div", { className: styles$d.uploadRowActions, children: [canPause && (jsxRuntime.jsx("button", { type: "button", className: styles$d.uploadActionButton, onClick: () => pauseUpload(item.id), children: "Pause" })), canResume && (jsxRuntime.jsx("button", { type: "button", className: styles$d.uploadActionButton, onClick: () => resumeUpload(item.id), children: actionLabel }))] }), item.errorMessage && item.status === 'failed' && (jsxRuntime.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] = react.useState(false);
+        const [editor, setEditor] = react.useState(null);
+        const [isFocused, setIsFocused] = react.useState(false);
+        const [isTouchDevice, setIsTouchDevice] = react.useState(false);
+        const [isSavedShown, setIsSavedShown] = react.useState(false);
+        const monaco = Editor.useMonaco();
+        const instanceIdRef = react.useRef(++notebookStyleCounter);
+        const instanceClass = `book-editor-instance-${instanceIdRef.current}`;
+        const touchStartRef = react.useRef(null);
+        const fileUploadInputRef = react.useRef(null);
+        const cameraInputRef = react.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,
+        });
+        react.useEffect(() => {
+            setIsTouchDevice(typeof window !== 'undefined' && window.matchMedia('(pointer: coarse)').matches);
+        }, []);
+        react.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 = react.useCallback(async (files) => {
-            var _a;
-            if (!onFileUpload || !editor || !monaco) {
-                return;
-            }
-            if (files.length === 0) {
-                return;
-            }
-            const model = editor.getModel();
-            if (!model) {
+        react.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 = react.useCallback(async (event) => {
             event.preventDefault();
             setIsDragOver(false);
             const files = Array.from(event.dataTransfer.files);
             await handleFiles(files);
         }, [handleFiles]);
-        /**
-         * Handles paste uploads.
-         */
         const handlePaste = react.useCallback(async (event) => {
             const files = Array.from(event.clipboardData.files);
             if (files.length === 0) {
@@ -13871,95 +14387,58 @@
             event.stopPropagation();
             await handleFiles(files);
         }, [handleFiles]);
-        // <- TODO: [✨🏺] !!!! Maybe not working
-        /**
-         * Opens the document upload input.
-         */
         const handleUploadDocument = react.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 = react.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 = react.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 = react.useCallback((event) => {
             event.preventDefault();
             setIsDragOver(true);
         }, []);
-        /**
-         * Shows drag overlay when entering the editor.
-         */
         const handleDragEnter = react.useCallback((event) => {
             event.preventDefault();
             setIsDragOver(true);
         }, []);
-        /**
-         * Hides drag overlay when leaving the editor.
-         */
         const handleDragLeave = react.useCallback((event) => {
             event.preventDefault();
             setIsDragOver(false);
         }, []);
-        const uploadStats = react.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 = react.useMemo(() => uploadItems.filter((item) => item.status !== 'completed'), [uploadItems]);
-        return (jsxRuntime.jsxs("div", { className: classNames(styles$d.bookEditorContainer, instanceClass), onDrop: handleDrop, onPaste: handlePaste, onDragOver: handleDragOver, onDragEnter: handleDragEnter, onDragLeave: handleDragLeave, children: [(isUploadButtonShown ||
-                    isCameraButtonShown ||
-                    isDownloadButtonShown ||
-                    isAboutButtonShown ||
-                    isFullscreenButtonShown) && (jsxRuntime.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 (jsxRuntime.jsxs("div", { className: classNames(styles$d.bookEditorContainer, instanceClass), onDrop: handleDrop, onPaste: handlePaste, onDragOver: handleDragOver, onDragEnter: handleDragEnter, onDragLeave: handleDragLeave, children: [isActionBarVisible && (jsxRuntime.jsx(BookEditorActionbar, { value,
                     isUploadButtonShown,
                     isCameraButtonShown: isCameraButtonShown !== null && isCameraButtonShown !== void 0 ? isCameraButtonShown : isTouchDevice,
                     isDownloadButtonShown,
@@ -13968,20 +14447,11 @@
                     onFullscreenClick,
                     onUploadDocument: handleUploadDocument,
                     onTakePhoto: handleTakePhoto,
-                    isFullscreen })), jsxRuntime.jsx("input", { type: "file", ref: fileUploadInputRef, style: { display: 'none' }, onChange: handleFileInputChange, multiple: true }), jsxRuntime.jsx("input", { type: "file", ref: cameraInputRef, style: { display: 'none' }, accept: "image/*", capture: "environment", onChange: handleFileInputChange }), isDragOver && jsxRuntime.jsx("div", { className: styles$d.dropOverlay, children: "Drop files to upload" }), isSavedShown && (jsxRuntime.jsxs("div", { className: styles$d.savedNotification, children: [jsxRuntime.jsx(SaveIcon, {}), "Saved"] })), activeUploadItems.length > 0 && (jsxRuntime.jsxs("div", { className: styles$d.uploadPanel, role: "status", "aria-live": "polite", children: [jsxRuntime.jsxs("div", { className: styles$d.uploadPanelHeader, children: [jsxRuntime.jsx("div", { className: styles$d.uploadPanelTitle, children: "Uploads" }), jsxRuntime.jsxs("div", { className: styles$d.uploadPanelHeaderMeta, children: [uploadStats.uploadingFiles + uploadStats.queuedFiles, " active / ", uploadStats.totalFiles, ' ', "total"] })] }), jsxRuntime.jsxs("div", { className: styles$d.uploadPanelSummary, children: [jsxRuntime.jsxs("div", { children: ["Files: ", uploadStats.totalFiles, " total, ", uploadStats.completedFiles, " done"] }), jsxRuntime.jsxs("div", { children: ["Data: ", formatBytes(uploadStats.uploadedBytes), " / ", formatBytes(uploadStats.totalBytes)] }), jsxRuntime.jsxs("div", { children: ["Speed:", ' ', uploadStats.speedBytesPerSecond > 0
-                                            ? `${formatBytes(uploadStats.speedBytesPerSecond)}/s`
-                                            : '--'] }), jsxRuntime.jsxs("div", { children: ["Elapsed: ", formatDuration(uploadStats.elapsedMs)] }), jsxRuntime.jsxs("div", { children: ["Paused: ", uploadStats.pausedFiles, ", Failed: ", uploadStats.failedFiles] })] }), jsxRuntime.jsx("div", { className: styles$d.uploadPanelProgressBar, children: jsxRuntime.jsx("div", { className: styles$d.uploadPanelProgressFill, style: { width: `${Math.round(uploadStats.progress * 100)}%` } }) }), jsxRuntime.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 (jsxRuntime.jsxs("div", { className: styles$d.uploadRow, children: [jsxRuntime.jsxs("div", { className: styles$d.uploadRowHeader, children: [jsxRuntime.jsx("div", { className: styles$d.uploadRowName, title: item.fileName, children: item.fileName }), jsxRuntime.jsx("div", { className: styles$d.uploadRowStatus, children: UPLOAD_STATUS_LABELS[item.status] })] }), jsxRuntime.jsxs("div", { className: styles$d.uploadRowMeta, children: [jsxRuntime.jsxs("span", { children: [formatBytes(item.loadedBytes), " / ", formatBytes(item.totalBytes)] }), jsxRuntime.jsxs("span", { children: [percent, "%"] })] }), jsxRuntime.jsx("div", { className: styles$d.uploadRowProgressBar, children: jsxRuntime.jsx("div", { className: styles$d.uploadRowProgressFill, style: { width: `${percent}%` } }) }), jsxRuntime.jsxs("div", { className: styles$d.uploadRowActions, children: [canPause && (jsxRuntime.jsx("button", { type: "button", className: styles$d.uploadActionButton, onClick: () => pauseUpload(item.id), children: "Pause" })), canResume && (jsxRuntime.jsx("button", { type: "button", className: styles$d.uploadActionButton, onClick: () => resumeUpload(item.id), children: actionLabel }))] }), item.errorMessage && item.status === 'failed' && (jsxRuntime.jsx("div", { className: styles$d.uploadRowError, children: item.errorMessage }))] }, item.id));
-                            }) })] })), jsxRuntime.jsxs("div", { style: {
+                    isFullscreen })), jsxRuntime.jsx("input", { type: "file", ref: fileUploadInputRef, style: { display: 'none' }, onChange: handleFileInputChange, multiple: true }), jsxRuntime.jsx("input", { type: "file", ref: cameraInputRef, style: { display: 'none' }, accept: "image/*", capture: "environment", onChange: handleFileInputChange }), isDragOver && jsxRuntime.jsx("div", { className: styles$d.dropOverlay, children: "Drop files to upload" }), isSavedShown && (jsxRuntime.jsxs("div", { className: styles$d.savedNotification, children: [jsxRuntime.jsx(SaveIcon, {}), "Saved"] })), jsxRuntime.jsx(BookEditorMonacoUploadPanel, { activeUploadItems: activeUploadItems, uploadStats: uploadStats, pauseUpload: pauseUpload, resumeUpload: resumeUpload }), jsxRuntime.jsxs("div", { style: {
                         position: 'relative',
                         flex: 1,
                         height: '100%',
                         width: '100%',
-                        // outline: '1px dotted #ff3333'
                     }, children: [isTouchDevice && !isFocused && (jsxRuntime.jsx("div", { style: {
                                 position: 'absolute',
                                 top: 0,
@@ -13992,29 +14462,7 @@
                                 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;
-                            } })), jsxRuntime.jsx(Editor__default["default"], { language: BOOK_LANGUAGE_ID, value: value, onMount: (editor) => setEditor(editor), onChange: (newValue) => onChange === null || onChange === void 0 ? void 0 : onChange(newValue), options: {
+                            }, ...focusOverlayTouchHandlers })), jsxRuntime.jsx(Editor__default["default"], { 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',
@@ -14023,13 +14471,9 @@
                                 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,
@@ -15149,7 +15593,7 @@
      *
      * @private Internal helper of the HTML export renderer.
      */
-    function escapeHtml(value) {
+    function escapeHtml$1(value) {
         return String(value)
             .replace(/&/g, '&amp;')
             .replace(/</g, '&lt;')
@@ -15169,7 +15613,7 @@
         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;
@@ -15264,9 +15708,9 @@
             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__default["default"](`
             <${tag} class="attachment-chip"${href}>
                 <span class="attachment-icon">📎</span>
@@ -15288,15 +15732,15 @@
             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__default["default"](`
             <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}
@@ -15322,8 +15766,8 @@
         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__default["default"](`
         <article class="message-block ${alignmentClass}">
             <div class="message-avatar">${avatarMarkup}</div>
@@ -15331,14 +15775,14 @@
                 <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}
@@ -15356,7 +15800,7 @@
         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);
@@ -15777,13 +16221,13 @@
                         <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__default["default"](`
                                                 <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('')}
@@ -15800,8 +16244,8 @@
                                 <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">
@@ -15811,7 +16255,7 @@
                     <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" />
@@ -21974,27 +22418,6 @@
      * 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
      *
@@ -25770,6 +26193,24 @@
             ],
         });
     }
+    /**
+     * 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
@@ -25914,7 +26355,7 @@
          * 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');
@@ -25922,6 +26363,14 @@
             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}`
@@ -25937,9 +26386,7 @@
                         ? [...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
@@ -25949,27 +26396,34 @@
             };
             console.log('!!!! promptWithAgentModelRequirements:', promptWithAgentModelRequirements);
             if (OpenAiAgentKitExecutionTools.isOpenAiAgentKitExecutionTools(this.options.llmTools)) {
-                const requirementsHash = cryptoJs.SHA256(JSON.stringify(sanitizedRequirements)).toString();
-                const vectorStoreHash = cryptoJs.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 = cryptoJs.SHA256(JSON.stringify(sanitizedRequirements)).toString();
+                    vectorStoreHash = cryptoJs.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) {
@@ -25977,7 +26431,7 @@
                             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,
@@ -25994,22 +26448,24 @@
                     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,
@@ -26166,9 +26622,148 @@
      * 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__default["default"].bgCyan('[Self-learning]') + colors__default["default"].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 waitasecond.forTime(Math.random() * 5000);
+            console.info(colors__default["default"].bgCyan('[Self-learning]') + colors__default["default"].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__default["default"].bgCyan('[Self-learning]') + colors__default["default"].cyan(' Sampling'));
+            const learningExample = spaceTrim__default["default"]((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__default["default"].bgCyan('[Self-learning]') + colors__default["default"].cyan(' Teacher'));
+            const teacherPromptContent = spaceTrim__default["default"]((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__default["default"].bgCyan('[Self-learning]') +
+                    colors__default["default"].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__default["default"](currentSource) + section));
+            this.options.updateAgentSource(newSource);
+        }
+    }
     /**
      * Creates an empty commitment breakdown for self-learning summaries.
+     *
+     * @private function of Agent
      */
     function createEmptySelfLearningCommitmentCounts() {
         return {
@@ -26181,6 +26776,9 @@
     }
     /**
      * Normalizes teacher commitments into trimmed, display-ready lines.
+     *
+     * @param commitments Raw teacher output
+     * @private function of Agent
      */
     function getTeacherCommitmentLines(commitments) {
         return commitments
@@ -26190,6 +26788,9 @@
     }
     /**
      * 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;
@@ -26217,6 +26818,11 @@
     }
     /**
      * 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);
@@ -26226,6 +26832,34 @@
             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
      *
@@ -26268,7 +26902,6 @@
                 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
@@ -26307,8 +26940,12 @@
             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);
@@ -26332,6 +26969,7 @@
          * 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) {
@@ -26382,6 +27020,10 @@
             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',
@@ -26393,24 +27035,7 @@
                 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__default["default"].bgCyan('[Self-learning]') + colors__default["default"].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 = {
@@ -26432,110 +27057,6 @@
             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 waitasecond.forTime(Math.random() * 5000);
-        // <- TODO: [🕓] `await forRandom(...)`
-        console.info(colors__default["default"].bgCyan('[Self-learning]') + colors__default["default"].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__default["default"](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__default["default"].bgCyan('[Self-learning]') + colors__default["default"].cyan(' Sampling'));
-        const learningExample = spaceTrim__default["default"]((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__default["default"](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__default["default"].bgCyan('[Self-learning]') + colors__default["default"].cyan(' Teacher'));
-        const teacherResult = await this.teacherAgent.callChatModel({
-            title: 'Self-learning',
-            modelRequirements: {
-                modelVariant: 'CHAT',
-            },
-            // TODO: !!!! Use prompt notation
-            content: spaceTrim__default["default"]((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__default["default"].bgCyan('[Self-learning]') +
-                colors__default["default"].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__default["default"](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?
      */
@@ -26810,13 +27331,23 @@
             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;
         }
@@ -26838,7 +27369,7 @@
          * Returns undefined if voice calling is disabled
          */
         get callVoiceChatModel() {
-            if (!this._isVoiceCallingEnabled) {
+            if (!this._isVoiceCallingEnabled || !this._isVoiceTtsSttEnabled) {
                 return undefined;
             }
             return async (audio, prompt) => {
@@ -26901,6 +27432,7 @@
             const toolCalls = [];
             const preparationToolCalls = [];
             let hasReceivedModelOutput = false;
+            let pendingToolCallLineFragment = '';
             const normalizeToolCall = (toolCall) => {
                 if (toolCall.createdAt) {
                     return toolCall;
@@ -26953,6 +27485,113 @@
              * 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();
             }
@@ -26968,84 +27607,26 @@
                         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 {
@@ -28449,6 +29030,7 @@
         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
@@ -28709,8 +29291,8 @@
         return (jsxRuntime.jsxs("div", { className: styles$5.imagePrompt, "aria-live": "polite", children: [jsxRuntime.jsxs("div", { className: styles$5.imagePromptPreview, children: [status === 'success' && imageUrl ? (jsxRuntime.jsx("img", { src: imageUrl, alt: alt, className: styles$5.imagePromptImage })) : (jsxRuntime.jsx("div", { className: styles$5.imagePromptPlaceholder, children: jsxRuntime.jsx("div", { className: styles$5.imagePromptSpinner }) })), status === 'error' && error && jsxRuntime.jsx("div", { className: styles$5.imagePromptError, children: error })] }), jsxRuntime.jsxs("div", { className: styles$5.imagePromptMeta, children: [jsxRuntime.jsx("span", { className: styles$5.imagePromptPrompt, children: trimmedPrompt || 'Generated image' }), jsxRuntime.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);
 
     /**
@@ -28719,6 +29301,206 @@
      * @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__default["default"].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__default["default"].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.
      *
@@ -28754,17 +29536,9 @@
             });
             layer.addTo(map);
             const geoJsonLayer = L__default["default"].geoJSON(data, {
-                style: () => ({
-                    color: '#6EE7B7',
-                    weight: 3,
-                }),
-                pointToLayer: (_feature, latlng) => L__default["default"].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();
@@ -29126,11 +29900,10 @@
      * 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)) {
@@ -29139,6 +29912,21 @@
         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.
      */
@@ -29173,15 +29961,17 @@
     /**
      * 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,
@@ -29192,17 +29982,11 @@
                 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);
@@ -29220,7 +30004,7 @@
     //                                          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;
@@ -29322,15 +30106,16 @@
         const [isAudioLoading, setIsAudioLoading] = react.useState(false);
         const [isAudioPlaying, setIsAudioPlaying] = react.useState(false);
         const [audioError, setAudioError] = react.useState(null);
-        const ongoingToolCallGroups = react.useMemo(() => groupOngoingToolCalls(message.ongoingToolCalls, toolTitles, teammates), [message.ongoingToolCalls, toolTitles, teammates]);
+        const ongoingToolCallGroups = react.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.
          *
@@ -29556,7 +30341,7 @@
                                         return null;
                                     }) })), message.attachments && message.attachments.length > 0 && (jsxRuntime.jsx("div", { className: styles$5.attachments, children: message.attachments.map((attachment, index) => (jsxRuntime.jsxs("a", { href: attachment.url, target: "_blank", rel: "noopener noreferrer", className: styles$5.attachment, title: attachment.name, children: [jsxRuntime.jsx("span", { className: styles$5.attachmentIcon, children: "\uD83D\uDCCE" }), jsxRuntime.jsx("span", { className: styles$5.attachmentName, children: attachment.name })] }, index))) })), completedToolCalls && completedToolCalls.length > 0 && (jsxRuntime.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) {
@@ -29577,7 +30362,9 @@
                                                 }, children: chipletText }, index));
                                         }), transitiveToolCalls.map((toolCallEntry, index) => {
                                             const chipletInfo = getToolCallChipletInfo(toolCallEntry.toolCall);
-                                            const chipletText = buildToolCallChipText(chipletInfo);
+                                            const chipletText = resolveToolCallChipLabel(toolCallEntry.toolCall, {
+                                                chipletInfo,
+                                            });
                                             return (jsxRuntime.jsxs("button", { className: styles$5.completedToolCall, onClick: (event) => {
                                                     event.stopPropagation();
                                                     if (onToolCallClick) {
@@ -29590,7 +30377,7 @@
                                             return (jsxRuntime.jsx(AgentChip, { agent: group.teamAgentData, isOngoing: true, labelSuffix: labelSuffix }, group.key));
                                         }
                                         const label = buildOngoingToolCallLabel(group);
-                                        return (jsxRuntime.jsxs("div", { className: styles$5.ongoingToolCall, children: [jsxRuntime.jsx("div", { className: styles$5.ongoingToolCallSpinner }), jsxRuntime.jsx("span", { className: styles$5.ongoingToolCallName, children: `${group.emoji} ${label}...` })] }, group.key));
+                                        return (jsxRuntime.jsxs("div", { className: styles$5.ongoingToolCall, children: [jsxRuntime.jsx("div", { className: styles$5.ongoingToolCallSpinner }), jsxRuntime.jsx("span", { className: styles$5.ongoingToolCallName, children: `${label}...` })] }, group.key));
                                     }) })), shouldShowButtons && (jsxRuntime.jsx("div", { className: styles$5.messageButtons, children: buttons.map((button, buttonIndex) => (jsxRuntime.jsx("button", { className: styles$5.messageButton, onClick: (event) => {
                                             event.stopPropagation();
                                             if (onMessage) {
@@ -29687,7 +30474,7 @@
      * @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;
@@ -29699,7 +30486,7 @@
                     const isLastMessage = index === messages.length - 1;
                     const isExpanded = expandedMessageId === message.id;
                     const currentRating = messageRatings.get(message.id || message.content /* <-[??] */) || 0;
-                    return (jsxRuntime.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 (jsxRuntime.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));
                 }), jsxRuntime.jsx("div", { style: { height: 100 } })] }));
     }
 
@@ -30903,7 +31690,7 @@
      * @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 = react.useMemo(() => Color.from(buttonColorRaw || '#0066cc'), [buttonColorRaw]);
         const agentParticipant = react.useMemo(() => participants.find((participant) => participant.name === 'AGENT'), [participants]);
         const postprocessedMessages = react.useMemo(() => {
@@ -31077,7 +31864,7 @@
                                 }, onCitationClick: (citation) => {
                                     setSelectedCitation(citation);
                                     setCitationModalOpen(true);
-                                }, setChatMessagesElement: setChatMessagesElement, onScroll: handleChatScroll, chatMessagesClassName: useChatCssClassName('chatMessages'), hasActions: hasActions }), onMessage && (jsxRuntime.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') }))] }) }), jsxRuntime.jsx(ChatToolCallModal, { isOpen: toolCallModalOpen, toolCall: selectedToolCall, onClose: () => setToolCallModalOpen(false), toolTitles: toolTitles, agentParticipant: agentParticipant, buttonColor: buttonColor }), jsxRuntime.jsx(ChatCitationModal, { isOpen: citationModalOpen, citation: selectedCitation, participants: participants, soundSystem: soundSystem, onClose: () => setCitationModalOpen(false) }), jsxRuntime.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 && (jsxRuntime.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') }))] }) }), jsxRuntime.jsx(ChatToolCallModal, { isOpen: toolCallModalOpen, toolCall: selectedToolCall, onClose: () => setToolCallModalOpen(false), toolTitles: toolTitles, agentParticipant: agentParticipant, buttonColor: buttonColor }), jsxRuntime.jsx(ChatCitationModal, { isOpen: citationModalOpen, citation: selectedCitation, participants: participants, soundSystem: soundSystem, onClose: () => setCitationModalOpen(false) }), jsxRuntime.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 })] }));
     }
 
     /**
@@ -31225,6 +32012,23 @@
         }
         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
      *
@@ -31238,7 +32042,8 @@
      * @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 = react.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)
@@ -31414,7 +32219,7 @@
                 const prompt = {
                     title: 'User Message',
                     content: messageContent,
-                    parameters: {},
+                    parameters: resolvedPromptParameters,
                     modelRequirements: {
                         modelVariant: 'CHAT',
                     },
@@ -31504,9 +32309,22 @@
             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 = react.useCallback(async () => {
+            if (resetMode === 'delegate' && onReset) {
+                await onReset();
+                return;
+            }
             // Re-seed with initialMessages instead of empty array
             setMessages(buildInitialMessages());
             setTasksProgress([]);
@@ -31521,7 +32339,7 @@
             if (onReset) {
                 await onReset();
             }
-        }, [persistenceKey, onReset, buildInitialMessages]);
+        }, [buildInitialMessages, onReset, persistenceKey, resetMode]);
         // Handle retry of last failed message
         const handleRetry = react.useCallback(() => {
             if (lastFailedMessage) {