@promptbook/remote-server 0.103.0-1 → 0.103.0-100

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('express'), require('express-openapi-validator'), require('http'), require('socket.io'), require('spacetrim'), require('swagger-ui-express'), require('waitasecond'), require('crypto'), require('child_process'), require('fs/promises'), require('path'), require('rxjs'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('crypto-js'), require('mime-types'), require('papaparse'), require('react'), require('react-dom/server')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'express', 'express-openapi-validator', 'http', 'socket.io', 'spacetrim', 'swagger-ui-express', 'waitasecond', 'crypto', 'child_process', 'fs/promises', 'path', 'rxjs', 'crypto-js/enc-hex', 'crypto-js/sha256', 'crypto-js', 'mime-types', 'papaparse', 'react', 'react-dom/server'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-remote-server"] = {}, global.colors, global.express, global.OpenApiValidator, global.http, global.socket_io, global.spaceTrim, global.swaggerUi, global.waitasecond, global.crypto, global.child_process, global.promises, global.path, global.rxjs, global.hexEncoder, global.sha256, global.cryptoJs, global.mimeTypes, global.papaparse, global.react, global.server));
-})(this, (function (exports, colors, express, OpenApiValidator, http, socket_io, spaceTrim, swaggerUi, waitasecond, crypto, child_process, promises, path, rxjs, hexEncoder, sha256, cryptoJs, mimeTypes, papaparse, react, server) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('path'), require('child_process'), require('colors'), require('spacetrim'), require('waitasecond'), require('express'), require('express-openapi-validator'), require('http'), require('socket.io'), require('swagger-ui-express'), require('crypto'), require('fs/promises'), require('rxjs'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('crypto-js'), require('mime-types'), require('papaparse'), require('react'), require('react-dom/server')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'path', 'child_process', 'colors', 'spacetrim', 'waitasecond', 'express', 'express-openapi-validator', 'http', 'socket.io', 'swagger-ui-express', 'crypto', 'fs/promises', 'rxjs', 'crypto-js/enc-hex', 'crypto-js/sha256', 'crypto-js', 'mime-types', 'papaparse', 'react', 'react-dom/server'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-remote-server"] = {}, global.path, global.child_process, global.colors, global.spaceTrim$1, global.waitasecond, global.express, global.OpenApiValidator, global.http, global.socket_io, global.swaggerUi, global.crypto, global.promises, global.rxjs, global.hexEncoder, global.sha256, global.cryptoJs, global.mimeTypes, global.papaparse, global.react, global.server));
+})(this, (function (exports, path, child_process, colors, spaceTrim$1, waitasecond, express, OpenApiValidator, http, socket_io, swaggerUi, crypto, promises, rxjs, hexEncoder, sha256, cryptoJs, mimeTypes, papaparse, react, server) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -25,10 +25,10 @@
     }
 
     var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
+    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim$1);
     var express__default = /*#__PURE__*/_interopDefaultLegacy(express);
     var OpenApiValidator__namespace = /*#__PURE__*/_interopNamespace(OpenApiValidator);
     var http__default = /*#__PURE__*/_interopDefaultLegacy(http);
-    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
     var swaggerUi__default = /*#__PURE__*/_interopDefaultLegacy(swaggerUi);
     var hexEncoder__default = /*#__PURE__*/_interopDefaultLegacy(hexEncoder);
     var sha256__default = /*#__PURE__*/_interopDefaultLegacy(sha256);
@@ -40,19 +40,30 @@
      * @generated
      * @see https://github.com/webgptorg/book
      */
-    const BOOK_LANGUAGE_VERSION = '1.0.0';
+    const BOOK_LANGUAGE_VERSION = '2.0.0';
     /**
      * The version of the Promptbook engine
      *
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-1';
+    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-100';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * Trims string from all 4 sides
+     *
+     * Note: This is a re-exported function from the `spacetrim` package which is
+     *       Developed by same author @hejny as this package
+     *
+     * @public exported from `@promptbook/utils`
+     * @see https://github.com/hejny/spacetrim#usage
+     */
+    const spaceTrim = spaceTrim$1.spaceTrim;
+
     /**
      * @private util of `@promptbook/color`
      * @de
@@ -101,6 +112,7 @@
      * @public exported from `@promptbook/color`
      */
     const CSS_COLORS = {
+        promptbook: '#79EAFD',
         transparent: 'rgba(0,0,0,0)',
         aliceblue: '#f0f8ff',
         antiquewhite: '#faebd7',
@@ -282,9 +294,6 @@
             throw new Error(`${channelName} channel is greater than 255, it is ${value}`);
         }
     }
-    /**
-     * TODO: [🧠][🚓] Is/which combination it better to use asserts/check, validate or is utility function?
-     */
 
     /**
      * Color object represents an RGB color with alpha channel
@@ -319,6 +328,28 @@
                 throw new Error(`Can not create color from given object`);
             }
         }
+        /**
+         * Creates a new Color instance from miscellaneous formats
+         * It just does not throw error when it fails, it returns PROMPTBOOK_COLOR instead
+         *
+         * @param color
+         * @returns Color object
+         */
+        static fromSafe(color) {
+            try {
+                return Color.from(color);
+            }
+            catch (error) {
+                // <- Note: Can not use `assertsError(error)` here because it causes circular dependency
+                console.warn(spaceTrim((block) => `
+                        Color.fromSafe error:
+                        ${block(error.message)}
+
+                        Returning default PROMPTBOOK_COLOR.
+                    `));
+                return Color.fromString('promptbook');
+            }
+        }
         /**
          * Creates a new Color instance from miscellaneous string formats
          *
@@ -386,6 +417,9 @@
             if (hex.length === 3) {
                 return Color.fromHex3(hex);
             }
+            if (hex.length === 4) {
+                return Color.fromHex4(hex);
+            }
             if (hex.length === 6) {
                 return Color.fromHex6(hex);
             }
@@ -406,6 +440,19 @@
             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)
          *
@@ -596,7 +643,8 @@
          * @returns true if the value is a valid hex color string (e.g., `#009edd`, `#fff`, etc.)
          */
         static isHexColorString(value) {
-            return typeof value === 'string' && /^#(?:[0-9a-fA-F]{3}){1,2}$/.test(value);
+            return (typeof value === 'string' &&
+                /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(value));
         }
         /**
          * Creates new Color object
@@ -711,6 +759,23 @@
      * TODO: Maybe connect with textures
      */
 
+    /**
+     * Makes color transformer which returns a grayscale version of the color
+     *
+     * @param amount from 0 to 1
+     *
+     * @public exported from `@promptbook/color`
+     */
+    function grayscale(amount) {
+        return ({ red, green, blue, alpha }) => {
+            const average = (red + green + blue) / 3;
+            red = Math.round(average * amount + red * (1 - amount));
+            green = Math.round(average * amount + green * (1 - amount));
+            blue = Math.round(average * amount + blue * (1 - amount));
+            return Color.fromValues(red, green, blue, alpha);
+        };
+    }
+
     /**
      * Converts HSL values to RGB values
      *
@@ -826,102 +891,6 @@
      * TODO: Maybe implement by mix+hsl
      */
 
-    /**
-     * Calculates distance between two colors
-     *
-     * @param color1 first color
-     * @param color2 second color
-     *
-     * Note: This function is inefficient. Use colorDistanceSquared instead if possible.
-     *
-     * @public exported from `@promptbook/color`
-     */
-    /**
-     * Calculates distance between two colors without square root
-     *
-     * @param color1 first color
-     * @param color2 second color
-     *
-     * @public exported from `@promptbook/color`
-     */
-    function colorDistanceSquared(color1, color2) {
-        const rmean = (color1.red + color2.red) / 2;
-        const r = color1.red - color2.red;
-        const g = color1.green - color2.green;
-        const b = color1.blue - color2.blue;
-        const weightR = 2 + rmean / 256;
-        const weightG = 4.0;
-        const weightB = 2 + (255 - rmean) / 256;
-        const distance = weightR * r * r + weightG * g * g + weightB * b * b;
-        return distance;
-    }
-
-    /**
-     * Makes color transformer which finds the nearest color from the given list
-     *
-     * @param colors array of colors to choose from
-     *
-     * @public exported from `@promptbook/color`
-     */
-    function nearest(...colors) {
-        return (color) => {
-            const distances = colors.map((c) => colorDistanceSquared(c, color));
-            const minDistance = Math.min(...distances);
-            const minIndex = distances.indexOf(minDistance);
-            const nearestColor = colors[minIndex];
-            return nearestColor;
-        };
-    }
-
-    /**
-     * Color transformer which returns the negative color
-     *
-     * @public exported from `@promptbook/color`
-     */
-    function negative(color) {
-        const r = 255 - color.red;
-        const g = 255 - color.green;
-        const b = 255 - color.blue;
-        return Color.fromValues(r, g, b, color.alpha);
-    }
-
-    /**
-     * Makes color transformer which finds the furthest color from the given list
-     *
-     * @param colors array of colors to choose from
-     *
-     * @public exported from `@promptbook/color`
-     */
-    function furthest(...colors) {
-        return (color) => {
-            const furthestColor = negative(nearest(...colors.map(negative))(color));
-            return furthestColor;
-        };
-    }
-    /**
-     * Makes color transformer which finds the best text color (black or white) for the given background color
-     *
-     * @public exported from `@promptbook/color`
-     */
-    furthest(Color.get('white'), Color.from('black'));
-
-    /**
-     * Makes color transformer which returns a grayscale version of the color
-     *
-     * @param amount from 0 to 1
-     *
-     * @public exported from `@promptbook/color`
-     */
-    function grayscale(amount) {
-        return ({ red, green, blue, alpha }) => {
-            const average = (red + green + blue) / 3;
-            red = Math.round(average * amount + red * (1 - amount));
-            green = Math.round(average * amount + green * (1 - amount));
-            blue = Math.round(average * amount + blue * (1 - amount));
-            return Color.fromValues(red, green, blue, alpha);
-        };
-    }
-
     /**
      * Makes color transformer which saturate the given color
      *
@@ -998,16 +967,32 @@
      *
      * @public exported from `@promptbook/core`
      */
-    const PROMPTBOOK_COLOR = Color.fromHex('#79EAFD');
-    // <- TODO: [🧠] Using `Color` here increases the package size approx 3kb, maybe remove it
+    const PROMPTBOOK_COLOR = Color.fromString('promptbook');
+    // <- TODO: [🧠][🈵] Using `Color` here increases the package size approx 3kb, maybe remove it
+    /**
+     * Colors for syntax highlighting in the `<BookEditor/>`
+     *
+     * TODO: [🗽] Unite branding and make single place for it
+     *
+     * @public exported from `@promptbook/core`
+     */
+    ({
+        TITLE: Color.fromHex('#244EA8'),
+        LINE: Color.fromHex('#eeeeee'),
+        SEPARATOR: Color.fromHex('#cccccc'),
+        COMMITMENT: Color.fromHex('#DA0F78'),
+        PARAMETER: Color.fromHex('#8e44ad'),
+    });
+    // <- TODO: [🧠][🈵] Using `Color` here increases the package size approx 3kb, maybe remove it
     /**
-     * Dark color of the Promptbook
+     * Chat color of the Promptbook (in chat)
      *
      * TODO: [🗽] Unite branding and make single place for it
      *
      * @public exported from `@promptbook/core`
      */
     PROMPTBOOK_COLOR.then(lighten(0.1)).then(saturate(0.9)).then(grayscale(0.9));
+    // <- TODO: [🧠][🈵] Using `Color` and `lighten`, `saturate`,... here increases the package size approx 3kb, maybe remove it
     /**
      * Color of the user (in chat)
      *
@@ -1016,6 +1001,7 @@
      * @public exported from `@promptbook/core`
      */
     Color.fromHex('#1D4ED8');
+    // <- TODO: [🧠][🈵] Using `Color` here increases the package size approx 3kb, maybe remove it
     /**
      * When the title is not provided, the default title is used
      *
@@ -1102,7 +1088,7 @@
      * @public exported from `@promptbook/core`
      */
     const DEFAULT_MAX_EXECUTION_ATTEMPTS = 7; // <- TODO: [🤹‍♂️]
-    // <- TODO: [🕝] Make also `BOOKS_DIRNAME_ALTERNATIVES`
+    // <- TODO: [🕝] Make also `AGENTS_DIRNAME_ALTERNATIVES`
     // TODO: Just `.promptbook` in config, hardcode subfolders like `download-cache` or `execution-cache`
     /**
      * Where to store the temporary downloads
@@ -1151,24 +1137,246 @@
      */
     const DEFAULT_TASK_SIMULATED_DURATION_MS = 5 * 60 * 1000; // 5 minutes
     /**
-     * API request timeout in milliseconds
-     * Can be overridden via API_REQUEST_TIMEOUT environment variable
-     *
-     * @public exported from `@promptbook/core`
+     * API request timeout in milliseconds
+     * Can be overridden via API_REQUEST_TIMEOUT environment variable
+     *
+     * @public exported from `@promptbook/core`
+     */
+    parseInt(process.env.API_REQUEST_TIMEOUT || '90000');
+    /**
+     * Indicates whether pipeline logic validation is enabled. When true, the pipeline logic is checked for consistency.
+     *
+     * @private within the repository
+     */
+    const IS_PIPELINE_LOGIC_VALIDATED = just(
+    /**/
+    // Note: In normal situations, we check the pipeline logic:
+    true);
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     * TODO: [🧠][🧜‍♂️] Maybe join remoteServerUrl and path into single value
+     */
+
+    /**
+     * This error type indicates that you try to use a feature that is not available in the current environment
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class EnvironmentMismatchError extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'EnvironmentMismatchError';
+            Object.setPrototypeOf(this, EnvironmentMismatchError.prototype);
+        }
+    }
+
+    /**
+     * Detects if the code is running in a Node.js environment
+     *
+     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    const $isRunningInNode = new Function(`
+    try {
+        return this === global;
+    } catch (e) {
+        return false;
+    }
+`);
+    /**
+     * TODO: [🎺]
+     */
+
+    /**
+     * Normalize options for `execCommand` and `execCommands`
+     *
+     * Note: `$` is used to indicate that this function behaves differently according to `process.platform`
+     *
+     * @private internal utility of `execCommand` and `execCommands`
+     */
+    function $execCommandNormalizeOptions(options) {
+        var _a, _b, _c, _d;
+        let command;
+        let cwd;
+        let crashOnError;
+        let args = [];
+        let timeout;
+        let isVerbose;
+        if (typeof options === 'string') {
+            // TODO: [1] DRY default values
+            command = options;
+            cwd = process.cwd();
+            crashOnError = true;
+            timeout = Infinity; // <- TODO: [⏳]
+            isVerbose = DEFAULT_IS_VERBOSE;
+        }
+        else {
+            /*
+            TODO:
+            if ((options as any).commands !== undefined) {
+                commands = (options as any).commands;
+            } else {
+                commands = [(options as any).command];
+            }
+            */
+            // TODO: [1] DRY default values
+            command = options.command;
+            cwd = (_a = options.cwd) !== null && _a !== void 0 ? _a : process.cwd();
+            crashOnError = (_b = options.crashOnError) !== null && _b !== void 0 ? _b : true;
+            timeout = (_c = options.timeout) !== null && _c !== void 0 ? _c : Infinity;
+            isVerbose = (_d = options.isVerbose) !== null && _d !== void 0 ? _d : DEFAULT_IS_VERBOSE;
+        }
+        // TODO: /(-[a-zA-Z0-9-]+\s+[^\s]*)|[^\s]*/g
+        const _ = Array.from(command.matchAll(/(".*")|([^\s]*)/g))
+            .map(([match]) => match)
+            .filter((arg) => arg !== '');
+        if (_.length > 1) {
+            [command, ...args] = _;
+        }
+        if (options.args) {
+            args = [...args, ...options.args];
+        }
+        let humanReadableCommand = !['npx', 'npm'].includes(command) ? command : args[0];
+        if (['ts-node'].includes(humanReadableCommand)) {
+            humanReadableCommand += ` ${args[1]}`;
+        }
+        if (/^win/.test(process.platform) && ['npm', 'npx'].includes(command)) {
+            command = `${command}.cmd`;
+        }
+        return { command, humanReadableCommand, args, cwd, crashOnError, timeout, isVerbose };
+    }
+    // TODO: This should show type error> execCommandNormalizeOptions({ command: '', commands: [''] });
+
+    /**
+     * Run one command in a shell
+     *
+     *
+     * Note: There are 2 similar functions in the codebase:
+     * - `$execCommand` which runs a single command
+     * - `$execCommands` which runs multiple commands
+     * Note: `$` is used to indicate that this function is not a pure function - it runs a command in a shell
+     *
+     * @public exported from `@promptbook/node`
+     */
+    function $execCommand(options) {
+        if (!$isRunningInNode()) {
+            throw new EnvironmentMismatchError('Function `$execCommand` can run only in Node environment.js');
+        }
+        return new Promise((resolve, reject) => {
+            // eslint-disable-next-line prefer-const
+            const { command, humanReadableCommand, args, cwd, crashOnError, timeout, isVerbose = DEFAULT_IS_VERBOSE, } = $execCommandNormalizeOptions(options);
+            if (timeout !== Infinity) {
+                // TODO: In waitasecond forTime(Infinity) should be equivalent to forEver()
+                waitasecond.forTime(timeout).then(() => {
+                    if (crashOnError) {
+                        reject(new Error(`Command "${humanReadableCommand}" exceeded time limit of ${timeout}ms`));
+                    }
+                    else {
+                        console.warn(`Command "${humanReadableCommand}" exceeded time limit of ${timeout}ms but continues running`);
+                        // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
+                        resolve('Command exceeded time limit');
+                    }
+                });
+            }
+            if (isVerbose) {
+                console.info(colors__default["default"].yellow(cwd) + ' ' + colors__default["default"].green(command) + ' ' + colors__default["default"].blue(args.join(' ')));
+            }
+            try {
+                const commandProcess = child_process.spawn(command, args, { cwd, shell: true });
+                if (isVerbose) {
+                    commandProcess.on('message', (message) => {
+                        console.info({ message });
+                    });
+                }
+                const output = [];
+                commandProcess.stdout.on('data', (stdout) => {
+                    output.push(stdout.toString());
+                    if (isVerbose) {
+                        console.info(stdout.toString());
+                    }
+                });
+                commandProcess.stderr.on('data', (stderr) => {
+                    output.push(stderr.toString());
+                    if (isVerbose && stderr.toString().trim()) {
+                        console.warn(stderr.toString());
+                        // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
+                    }
+                });
+                const finishWithCode = (code) => {
+                    if (code !== 0) {
+                        if (crashOnError) {
+                            reject(new Error(output.join('\n').trim() ||
+                                `Command "${humanReadableCommand}" exited with code ${code}`));
+                        }
+                        else {
+                            if (isVerbose) {
+                                console.warn(`Command "${humanReadableCommand}" exited with code ${code}`);
+                                // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
+                            }
+                            resolve(spaceTrim$1.spaceTrim(output.join('\n')));
+                        }
+                    }
+                    else {
+                        resolve(spaceTrim$1.spaceTrim(output.join('\n')));
+                    }
+                };
+                commandProcess.on('close', finishWithCode);
+                commandProcess.on('exit', finishWithCode);
+                commandProcess.on('disconnect', () => {
+                    // Note: Unexpected disconnection should always result in rejection
+                    reject(new Error(`Command "${humanReadableCommand}" disconnected`));
+                });
+                commandProcess.on('error', (error) => {
+                    if (crashOnError) {
+                        reject(new Error(`Command "${humanReadableCommand}" failed: \n${error.message}`));
+                    }
+                    else {
+                        if (isVerbose) {
+                            console.warn(error);
+                            // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
+                        }
+                        resolve(spaceTrim$1.spaceTrim(output.join('\n')));
+                    }
+                });
+            }
+            catch (error) {
+                // Note: Unexpected error in sync code should always result in rejection
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
-    parseInt(process.env.API_REQUEST_TIMEOUT || '90000');
+
     /**
-     * Indicates whether pipeline logic validation is enabled. When true, the pipeline logic is checked for consistency.
+     * [🐱‍🚀]
+     * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
      *
-     * @private within the repository
-     */
-    const IS_PIPELINE_LOGIC_VALIDATED = just(
-    /**/
-    // Note: In normal situations, we check the pipeline logic:
-    true);
+     * You can simply use `RemoteExecutionTools` on client-side javascript and connect to your remote server.
+     * This is useful to make all logic on browser side but not expose your API keys or no need to use customer's GPU.
+     *
+     * @see https://github.com/webgptorg/promptbook#remote-server
+     * @public exported from `@promptbook/remote-server`
+     * <- TODO: [🐱‍🚀] Change to `@promptbook/agent-server`
+     */
+    async function startAgentServer(options) {
+        const { port = 4440 } = options;
+        // TODO: [🐱‍🚀] [🌕]
+        const agentsServerRoot = path.join(__dirname, '../apps/agents-server');
+        console.trace(`!!! Starting agents server on port ${port}...`);
+        console.log(`!!! cwd`, process.cwd());
+        console.log(`!!! __dirname`, __dirname);
+        console.log(`!!! agentsServerRoot`, agentsServerRoot);
+        await $execCommand({
+            cwd: agentsServerRoot,
+            command: `next dev --port ${port} `,
+            isVerbose: true,
+        });
+    }
     /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     * TODO: [🧠][🧜‍♂️] Maybe join remoteServerUrl and path into single value
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
 
     /**
@@ -1222,7 +1430,7 @@
      */
     class UnexpectedError extends Error {
         constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
+            super(spaceTrim$1.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: This error should not happen.
@@ -1248,7 +1456,7 @@
         constructor(whatWasThrown) {
             const tag = `[🤮]`;
             console.error(tag, whatWasThrown);
-            super(spaceTrim.spaceTrim(`
+            super(spaceTrim$1.spaceTrim(`
                 Non-Error object was thrown
 
                 Note: Look for ${tag} in the console for more details
@@ -1303,6 +1511,7 @@
     /**
      * Generates random token
      *
+     * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic
      * Note: This function is cryptographically secure (it uses crypto.randomBytes internally)
      *
      * @private internal helper function
@@ -1312,6 +1521,7 @@
         return crypto.randomBytes(randomness).toString('hex');
     }
     /**
+     * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
      * TODO: Maybe use nanoid instead https://github.com/ai/nanoid
      */
 
@@ -1378,17 +1588,20 @@
     }
 
     /**
-     * This error type indicates that you try to use a feature that is not available in the current environment
+     * This error indicates error from the database
      *
      * @public exported from `@promptbook/core`
      */
-    class EnvironmentMismatchError extends Error {
+    class DatabaseError extends Error {
         constructor(message) {
             super(message);
-            this.name = 'EnvironmentMismatchError';
-            Object.setPrototypeOf(this, EnvironmentMismatchError.prototype);
+            this.name = 'DatabaseError';
+            Object.setPrototypeOf(this, DatabaseError.prototype);
         }
     }
+    /**
+     * TODO: [🐱‍🚀] Explain that NotFoundError ([🐱‍🚀] and other specific errors) has priority over DatabaseError in some contexts
+     */
 
     /**
      * This error occurs when some expectation is not met in the execution of the pipeline
@@ -1439,7 +1652,7 @@
      */
     class MissingToolsError extends Error {
         constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
+            super(spaceTrim$1.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: You have probably forgot to provide some tools for pipeline execution or preparation
@@ -1450,6 +1663,19 @@
         }
     }
 
+    /**
+     * This error indicates that promptbook operation is not allowed
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class NotAllowed extends Error {
+        constructor(message) {
+            super(message);
+            this.name = 'NotAllowed';
+            Object.setPrototypeOf(this, NotAllowed.prototype);
+        }
+    }
+
     /**
      * This error indicates that promptbook not found in the collection
      *
@@ -1470,7 +1696,7 @@
      */
     class NotYetImplementedError extends Error {
         constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
+            super(spaceTrim$1.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: This feature is not implemented yet but it will be soon.
@@ -1565,6 +1791,8 @@
         PromptbookFetchError,
         UnexpectedError,
         WrappedError,
+        NotAllowed,
+        DatabaseError,
         // TODO: [🪑]> VersionMismatchError,
     };
     /**
@@ -1632,186 +1860,6 @@
         };
     }
 
-    /**
-     * Detects if the code is running in a Node.js environment
-     *
-     * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
-     *
-     * @public exported from `@promptbook/utils`
-     */
-    const $isRunningInNode = new Function(`
-    try {
-        return this === global;
-    } catch (e) {
-        return false;
-    }
-`);
-    /**
-     * TODO: [🎺]
-     */
-
-    /**
-     * Normalize options for `execCommand` and `execCommands`
-     *
-     * Note: `$` is used to indicate that this function behaves differently according to `process.platform`
-     *
-     * @private internal utility of `execCommand` and `execCommands`
-     */
-    function $execCommandNormalizeOptions(options) {
-        var _a, _b, _c, _d;
-        let command;
-        let cwd;
-        let crashOnError;
-        let args = [];
-        let timeout;
-        let isVerbose;
-        if (typeof options === 'string') {
-            // TODO: [1] DRY default values
-            command = options;
-            cwd = process.cwd();
-            crashOnError = true;
-            timeout = Infinity; // <- TODO: [⏳]
-            isVerbose = DEFAULT_IS_VERBOSE;
-        }
-        else {
-            /*
-            TODO:
-            if ((options as any).commands !== undefined) {
-                commands = (options as any).commands;
-            } else {
-                commands = [(options as any).command];
-            }
-            */
-            // TODO: [1] DRY default values
-            command = options.command;
-            cwd = (_a = options.cwd) !== null && _a !== void 0 ? _a : process.cwd();
-            crashOnError = (_b = options.crashOnError) !== null && _b !== void 0 ? _b : true;
-            timeout = (_c = options.timeout) !== null && _c !== void 0 ? _c : Infinity;
-            isVerbose = (_d = options.isVerbose) !== null && _d !== void 0 ? _d : DEFAULT_IS_VERBOSE;
-        }
-        // TODO: /(-[a-zA-Z0-9-]+\s+[^\s]*)|[^\s]*/g
-        const _ = Array.from(command.matchAll(/(".*")|([^\s]*)/g))
-            .map(([match]) => match)
-            .filter((arg) => arg !== '');
-        if (_.length > 1) {
-            [command, ...args] = _;
-        }
-        if (options.args) {
-            args = [...args, ...options.args];
-        }
-        let humanReadableCommand = !['npx', 'npm'].includes(command) ? command : args[0];
-        if (['ts-node'].includes(humanReadableCommand)) {
-            humanReadableCommand += ` ${args[1]}`;
-        }
-        if (/^win/.test(process.platform) && ['npm', 'npx'].includes(command)) {
-            command = `${command}.cmd`;
-        }
-        return { command, humanReadableCommand, args, cwd, crashOnError, timeout, isVerbose };
-    }
-    // TODO: This should show type error> execCommandNormalizeOptions({ command: '', commands: [''] });
-
-    /**
-     * Run one command in a shell
-     *
-     *
-     * Note: There are 2 similar functions in the codebase:
-     * - `$execCommand` which runs a single command
-     * - `$execCommands` which runs multiple commands
-     * Note: `$` is used to indicate that this function is not a pure function - it runs a command in a shell
-     *
-     * @public exported from `@promptbook/node`
-     */
-    function $execCommand(options) {
-        if (!$isRunningInNode()) {
-            throw new EnvironmentMismatchError('Function `$execCommand` can run only in Node environment.js');
-        }
-        return new Promise((resolve, reject) => {
-            // eslint-disable-next-line prefer-const
-            const { command, humanReadableCommand, args, cwd, crashOnError, timeout, isVerbose = DEFAULT_IS_VERBOSE, } = $execCommandNormalizeOptions(options);
-            if (timeout !== Infinity) {
-                // TODO: In waitasecond forTime(Infinity) should be equivalent to forEver()
-                waitasecond.forTime(timeout).then(() => {
-                    if (crashOnError) {
-                        reject(new Error(`Command "${humanReadableCommand}" exceeded time limit of ${timeout}ms`));
-                    }
-                    else {
-                        console.warn(`Command "${humanReadableCommand}" exceeded time limit of ${timeout}ms but continues running`);
-                        // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
-                        resolve('Command exceeded time limit');
-                    }
-                });
-            }
-            if (isVerbose) {
-                console.info(colors__default["default"].yellow(cwd) + ' ' + colors__default["default"].green(command) + ' ' + colors__default["default"].blue(args.join(' ')));
-            }
-            try {
-                const commandProcess = child_process.spawn(command, args, { cwd, shell: true });
-                if (isVerbose) {
-                    commandProcess.on('message', (message) => {
-                        console.info({ message });
-                    });
-                }
-                const output = [];
-                commandProcess.stdout.on('data', (stdout) => {
-                    output.push(stdout.toString());
-                    if (isVerbose) {
-                        console.info(stdout.toString());
-                    }
-                });
-                commandProcess.stderr.on('data', (stderr) => {
-                    output.push(stderr.toString());
-                    if (isVerbose && stderr.toString().trim()) {
-                        console.warn(stderr.toString());
-                        // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
-                    }
-                });
-                const finishWithCode = (code) => {
-                    if (code !== 0) {
-                        if (crashOnError) {
-                            reject(new Error(output.join('\n').trim() ||
-                                `Command "${humanReadableCommand}" exited with code ${code}`));
-                        }
-                        else {
-                            if (isVerbose) {
-                                console.warn(`Command "${humanReadableCommand}" exited with code ${code}`);
-                                // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
-                            }
-                            resolve(spaceTrim.spaceTrim(output.join('\n')));
-                        }
-                    }
-                    else {
-                        resolve(spaceTrim.spaceTrim(output.join('\n')));
-                    }
-                };
-                commandProcess.on('close', finishWithCode);
-                commandProcess.on('exit', finishWithCode);
-                commandProcess.on('disconnect', () => {
-                    // Note: Unexpected disconnection should always result in rejection
-                    reject(new Error(`Command "${humanReadableCommand}" disconnected`));
-                });
-                commandProcess.on('error', (error) => {
-                    if (crashOnError) {
-                        reject(new Error(`Command "${humanReadableCommand}" failed: \n${error.message}`));
-                    }
-                    else {
-                        if (isVerbose) {
-                            console.warn(error);
-                            // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
-                        }
-                        resolve(spaceTrim.spaceTrim(output.join('\n')));
-                    }
-                });
-            }
-            catch (error) {
-                // Note: Unexpected error in sync code should always result in rejection
-                reject(error);
-            }
-        });
-    }
-    /**
-     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
-     */
-
     /**
      * Attempts to locate the specified application on a Linux system using the 'which' command.
      * Returns the path to the executable if found, or null otherwise.
@@ -1851,6 +1899,7 @@
             writeFile: promises.writeFile,
             readdir: promises.readdir,
             mkdir: promises.mkdir,
+            watch: promises.watch,
         };
     }
     /**
@@ -2239,7 +2288,7 @@
         TODO: [🧠] Is there a better implementation?
         > const propertyNames = Object.getOwnPropertyNames(objectValue);
         > for (const propertyName of propertyNames) {
-        >     const value = (objectValue as really_any)[propertyName];
+        >     const value = (objectValue as chococake)[propertyName];
         >     if (value && typeof value === 'object') {
         >         deepClone(value);
         >     }
@@ -2461,6 +2510,8 @@
      * -   if it is valid json
      * -   if it is meaningful
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param pipeline valid or invalid PipelineJson
      * @returns the same pipeline if it is logically valid
      * @throws {PipelineLogicError} on logical error in the pipeline
@@ -2478,7 +2529,7 @@
                 if (!(error instanceof PipelineLogicError)) {
                     throw error;
                 }
-                console.error(spaceTrim.spaceTrim((block) => `
+                console.error(spaceTrim$1.spaceTrim((block) => `
                         Pipeline is not valid but logic errors are temporarily disabled via \`IS_PIPELINE_LOGIC_VALIDATED\`
 
                         ${block(error.message)}
@@ -2505,7 +2556,7 @@
         })();
         if (pipeline.pipelineUrl !== undefined && !isValidPipelineUrl(pipeline.pipelineUrl)) {
             // <- Note: [🚲]
-            throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+            throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                     Invalid promptbook URL "${pipeline.pipelineUrl}"
 
                     ${block(pipelineIdentification)}
@@ -2513,7 +2564,7 @@
         }
         if (pipeline.bookVersion !== undefined && !isValidPromptbookVersion(pipeline.bookVersion)) {
             // <- Note: [🚲]
-            throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+            throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                     Invalid Promptbook Version "${pipeline.bookVersion}"
 
                     ${block(pipelineIdentification)}
@@ -2522,7 +2573,7 @@
         // TODO: [🧠] Maybe do here some proper JSON-schema / ZOD checking
         if (!Array.isArray(pipeline.parameters)) {
             // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-            throw new ParseError(spaceTrim.spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                     Pipeline is valid JSON but with wrong structure
 
                     \`PipelineJson.parameters\` expected to be an array, but got ${typeof pipeline.parameters}
@@ -2533,7 +2584,7 @@
         // TODO: [🧠] Maybe do here some proper JSON-schema / ZOD checking
         if (!Array.isArray(pipeline.tasks)) {
             // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-            throw new ParseError(spaceTrim.spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                     Pipeline is valid JSON but with wrong structure
 
                     \`PipelineJson.tasks\` expected to be an array, but got ${typeof pipeline.tasks}
@@ -2559,7 +2610,7 @@
         // Note: Check each parameter individually
         for (const parameter of pipeline.parameters) {
             if (parameter.isInput && parameter.isOutput) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
 
                         Parameter \`{${parameter.name}}\` can not be both input and output
 
@@ -2570,7 +2621,7 @@
             if (!parameter.isInput &&
                 !parameter.isOutput &&
                 !pipeline.tasks.some((task) => task.dependentParameterNames.includes(parameter.name))) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${parameter.name}}\` is created but not used
 
                         You can declare {${parameter.name}} as output parameter by adding in the header:
@@ -2582,7 +2633,7 @@
             }
             // Note: Testing that parameter is either input or result of some task
             if (!parameter.isInput && !pipeline.tasks.some((task) => task.resultingParameterName === parameter.name)) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${parameter.name}}\` is declared but not defined
 
                         You can do one of these:
@@ -2598,14 +2649,14 @@
         // Note: Checking each task individually
         for (const task of pipeline.tasks) {
             if (definedParameters.has(task.resultingParameterName)) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${task.resultingParameterName}}\` is defined multiple times
 
                         ${block(pipelineIdentification)}
                     `));
             }
             if (RESERVED_PARAMETER_NAMES.includes(task.resultingParameterName)) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter name {${task.resultingParameterName}} is reserved, please use different name
 
                         ${block(pipelineIdentification)}
@@ -2615,7 +2666,7 @@
             if (task.jokerParameterNames && task.jokerParameterNames.length > 0) {
                 if (!task.format &&
                     !task.expectations /* <- TODO: Require at least 1 -> min <- expectation to use jokers */) {
-                    throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                    throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                             Joker parameters are used for {${task.resultingParameterName}} but no expectations are defined
 
                             ${block(pipelineIdentification)}
@@ -2623,7 +2674,7 @@
                 }
                 for (const joker of task.jokerParameterNames) {
                     if (!task.dependentParameterNames.includes(joker)) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Parameter \`{${joker}}\` is used for {${task.resultingParameterName}} as joker but not in \`dependentParameterNames\`
 
                                 ${block(pipelineIdentification)}
@@ -2634,21 +2685,21 @@
             if (task.expectations) {
                 for (const [unit, { min, max }] of Object.entries(task.expectations)) {
                     if (min !== undefined && max !== undefined && min > max) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Min expectation (=${min}) of ${unit} is higher than max expectation (=${max})
 
                                 ${block(pipelineIdentification)}
                             `));
                     }
                     if (min !== undefined && min < 0) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Min expectation of ${unit} must be zero or positive
 
                                 ${block(pipelineIdentification)}
                             `));
                     }
                     if (max !== undefined && max <= 0) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Max expectation of ${unit} must be positive
 
                                 ${block(pipelineIdentification)}
@@ -2670,7 +2721,7 @@
         while (unresovedTasks.length > 0) {
             if (loopLimit-- < 0) {
                 // Note: Really UnexpectedError not LimitReachedError - this should not happen and be caught below
-                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Loop limit reached during detection of circular dependencies in \`validatePipeline\`
 
                         ${block(pipelineIdentification)}
@@ -2680,7 +2731,7 @@
             if (currentlyResovedTasks.length === 0) {
                 throw new PipelineLogicError(
                 // TODO: [🐎] DRY
-                spaceTrim.spaceTrim((block) => `
+                spaceTrim$1.spaceTrim((block) => `
 
                         Can not resolve some parameters:
                         Either you are using a parameter that is not defined, or there are some circular dependencies.
@@ -2921,11 +2972,11 @@
             throw deserializeError(errors[0]);
         }
         else {
-            throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+            throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                     Multiple errors occurred during Promptbook execution
 
                     ${block(errors
-            .map(({ name, stack, message }, index) => spaceTrim.spaceTrim((block) => `
+            .map(({ name, stack, message }, index) => spaceTrim$1.spaceTrim((block) => `
                                         ${name} ${index + 1}:
                                         ${block(stack || message)}
                                     `))
@@ -2952,6 +3003,7 @@
         let updatedAt = createdAt;
         const errors = [];
         const warnings = [];
+        const llmCalls = [];
         let currentValue = {};
         let customTldr = null;
         const partialResultSubject = new rxjs.Subject();
@@ -2967,6 +3019,9 @@
         }, (tldrInfo) => {
             customTldr = tldrInfo;
             updatedAt = new Date();
+        }, (llmCall) => {
+            llmCalls.push(llmCall);
+            updatedAt = new Date();
         });
         finalResultPromise
             .catch((error) => {
@@ -3089,7 +3144,7 @@
                 }
                 return {
                     percent: percent,
-                    message,
+                    message: message + ' (!!!fallback)',
                 };
             },
             get createdAt() {
@@ -3112,6 +3167,10 @@
                 return warnings;
                 // <- Note: [1] --||--
             },
+            get llmCalls() {
+                return [...llmCalls, { foo: '!!! bar' }];
+                // <- Note: [1] --||--
+            },
             get currentValue() {
                 return currentValue;
                 // <- Note: [1] --||--
@@ -3191,7 +3250,7 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
-    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge from Markdown\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book`\n-   INPUT PARAMETER `{knowledgeContent}` Markdown document content\n-   OUTPUT PARAMETER `{knowledgePieces}` The knowledge JSON object\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}\n```\n\n`-> {knowledgePieces}`\n"}],sourceFile:"./books/prepare-knowledge-from-markdown.book"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Keywords\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-keywords.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{keywords}` Keywords separated by comma\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}\n```\n\n`-> {keywords}`\n"}],sourceFile:"./books/prepare-knowledge-keywords.book"},{title:"Prepare Knowledge-piece Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge-piece Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-title.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{title}` The title of the document\n\n## Knowledge\n\n-   EXPECT MIN 1 WORD\n-   EXPECT MAX 8 WORDS\n\n```markdown\nYou are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-knowledge-title.book"},{title:"Prepare Persona",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book",formfactorName:"GENERIC",parameters:[{name:"availableModels",description:"List of available model names together with their descriptions as JSON",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelsRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n```json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n```\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n```json\n{availableModels}\n```\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",resultingParameterName:"modelsRequirements",format:"JSON",dependentParameterNames:["availableModels","personaDescription"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Persona\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-persona.book`\n-   INPUT PARAMETER `{availableModels}` List of available model names together with their descriptions as JSON\n-   INPUT PARAMETER `{personaDescription}` Description of the persona\n-   OUTPUT PARAMETER `{modelsRequirements}` Specific requirements for the model\n\n## Make modelRequirements\n\n-   FORMAT JSON\n\n```markdown\nYou are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n\\`\\`\\`json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n\\`\\`\\`\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n\\`\\`\\`json\n{availableModels}\n\\`\\`\\`\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}\n```\n\n`-> {modelsRequirements}`\n"}],sourceFile:"./books/prepare-persona.book"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-title.book",formfactorName:"GENERIC",parameters:[{name:"book",description:"The book to prepare the title for",isInput:true,isOutput:false},{name:"title",description:"Best title for the book",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-title",title:"Make title",content:"Make best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}",resultingParameterName:"title",expectations:{words:{min:1,max:8},lines:{min:1,max:1}},dependentParameterNames:["book"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-title.book`\n-   INPUT PARAMETER `{book}` The book to prepare the title for\n-   OUTPUT PARAMETER `{title}` Best title for the book\n\n## Make title\n\n-   EXPECT MIN 1 Word\n-   EXPECT MAX 8 Words\n-   EXPECT EXACTLY 1 Line\n\n```markdown\nMake best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-title.book"},{title:"📊 Curriculum Audit",pipelineUrl:"https://promptbook.studio/promptbook//examples/lsvp-asistent.book",formfactorName:"GENERIC",parameters:[{name:"result",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"prompt",title:"Prompt",content:"Asistent pro LŠVP\n\nPERSONA Jsi asistent pro RVP Lyceum v rámci Národního pedagogického institutu České Republiky\nMETA IMAGE https://edulk.cz/getFile/id:475818/type:large/02%20zna%C4%8Dka%20npi.jpg\nRULE Pokud jsi nejsi jistý, napiš nevím\nKNOWLEDGE ./241129_Lyceum_final.pdf\nCONTEXT Obecně dokážeš řešit libovolné ŠVP, aktuálně řešíš {Školní vzdělávací program LYCEUM}\nRULE Z {Porovnání RVP a ŠVP - postup} je nejdůležitější fáze 3\nKNOWLEDGE {Školní vzdělávací program LYCEUM}  ./ŠVP Lyceum - Finance v digitální době.pdf\nKNOWLEDGE @Slovník\n\n**Interní slovník - RVP/ŠVP**\n\n**RVP**\n\nRámcový vzdělávací program pro obor vzdělání Lyceum je dokument na národní úrovni, který formuluje požadavky na školní vzdělávací programy ve formě především očekávaných výsledků učení, kterých mají žáci absolvováním tohoto programu na dané škole dosáhnout.\n\n**ŠVP**\n\nŠkolní vzdělávací program pro obor vzdělání Lyceum je dokument každé jednotlivé školy, který popisuje v jakých vyučovacích předmětech/ vzdělávacích modulech a v jakých ročnících budou požadované očekávané výsledky učení naplněny. Zároveň formuluje další očekávané výsledky učení, které naplňují disponibilní část vyučovacího času určeného RVP pro tento obor vzdělání.\n\n**Očekávaný výsledek učení (OVU)**\n\nVyjadřuje jednotlivý požadavek na to, co mají žáci umět na konci vzdělávacího programu, tzn. jejich požadované kompetence. Je vyjádřen formulací, která je uvozena činnostním slovesem a dále obsahuje předmět této činnosti. Formulace je konkretizována resp. doplněna zpravidla formou odrážek vymezením dílčích znalostí, dovedností, postojů, jejichž splnění je předpokladem dosažení OVU jako celku.\n\n_Příklad:_\n\n<div class=\"joplin-table-wrapper\"><table><tbody><tr><th><p><strong>Žák/žákyně řídí realizaci jednoduchého projektu</strong></p></th></tr><tr><td><ul><li>naplánuje aktivity projektu</li></ul></td></tr><tr><td><ul><li>navrhne rozpočet projektu vzhledem k navrženým aktivitám</li></ul></td></tr><tr><td><ul><li>stanoví základní ukazatele a sleduje jejich naplňování</li></ul></td></tr><tr><td><ul><li>vede projektový tým</li></ul></td></tr><tr><td><ul><li>uvede, jak by řešil krizové situace v projektu</li></ul></td></tr><tr><td><ul><li>vyhodnotí úspěšnost projektu</li></ul></td></tr></tbody></table></div>\n\n**Vzdělávací oblasti**\n\nOčekávané výsledky učení jsou v **_RVP členěny do 4 vzdělávacích oblastí_**, které tvoří společný všeobecně vzdělávací základ:\n\n- Osobnostní rozvoj, vzdělávání ke zdraví, bezpečí a produktivnímu pracovnímu životu (kariéře)\n- Komunikační a jazykové vzdělávání\n- Aplikované vzdělávání STEM (Science, Technology, Engeneering, Math), tj. přírodní vědy, informatika, technika, matematika\n- Prakticky orientované vzdělávání společenskovědní a humanitní\n\nKaždá vzdělávací oblast se dále člení na okruhy, v jejichž rámci jsou OVU samostatně číslované.\n\n<div class=\"joplin-table-wrapper\"><table><tbody><tr><th rowspan=\"21\"><ul><li>Prakticky orientované vzdělávání společenskovědní a humanitní</li></ul></th><th rowspan=\"21\"><p><strong>Člověk, ekonomie a podnikání</strong></p></th><th rowspan=\"7\"><p><strong>1</strong></p></th><th><p><strong>zpracuje podklady související s podnikáním</strong></p></th></tr><tr><td><p>připraví podnikatelský záměr</p></td></tr><tr><td><p>sestaví zakladatelský rozpočet</p></td></tr><tr><td><p>zkalkuluje cenu zboží nebo služby</p></td></tr><tr><td><p>vysvětlí na příkladu základní povinnosti podnikatele vůči státu a zaměstnancům</p></td></tr><tr><td><p>vede daňovou evidenci</p></td></tr><tr><td><p>vysvětlí na příkladech etiku v podnikání</p></td></tr><tr><td rowspan=\"7\"><p><strong>2</strong></p></td><td><p><strong>řídí realizaci jednoduchého projektu</strong></p></td></tr><tr><td><p>naplánuje aktivity projektu</p></td></tr><tr><td><p>navrhne rozpočet projektu vzhledem k navrženým aktivitám</p></td></tr><tr><td><p>stanoví základní ukazatele a sleduje jejich naplňování</p></td></tr><tr><td><p>vede projektový tým</p></td></tr><tr><td><p>uvede, jak by řešil krizové situace v projektu</p></td></tr><tr><td><p>vyhodnotí úspěšnost projektu</p></td></tr><tr><td rowspan=\"7\"><p><strong>3</strong></p></td><td><p><strong>aplikuje ekonomické teorie v osobním a profesním životě</strong></p></td></tr><tr><td><p>vysvětlí základní ekonomické otázky</p></td></tr><tr><td><p>vysvětí stanovení rovnovážné ceny na dokonalém i nedokonalém trhu</p></td></tr><tr><td><p>charakterizuje výrobní faktory a vysvětlí hranici produkčních možností a náklady obětované příležitosti</p></td></tr><tr><td><p>uvede nejdůležitější makroekonomické pojmy a vliv jejich výše na kvalitu života a podnikání v daném státě</p></td></tr><tr><td><p>vysvětlí podstatu inflace a její důsledky na finanční situaci obyvatel a na příkladu ukáže jak se bránit jejím nepříznivým důsledkům</p></td></tr><tr><td><p>uvede hlavní výhody a nevýhody mezinárodního obchodu a vliv ochranářských opatření na ekonomickou situaci dané země</p></td></tr><tr><td></td><td></td><td><p><strong>4</strong></p></td><td><p>Atd.</p></td></tr></tbody></table></div>\n\n**Vyučovací předmět / vzdělávací modul**\n\nOčekávané výsledky učení jsou v **ŠVP** členěny do vyučovacích předmětů nebo vzdělávacích modulů, které jsou dále zařazeny do jednoho nebo více ročníků 4letého studia. Vyučovací předmět / vzdělávací modul tvoří vyučovací jednotku, kde jsou očekávané výsledky učení dále rozpracovány pro potřeby výuky podle následující šablony\n\n| **A. VSTUPNÍ ČÁST** |\n| --- |\n| **1\\. Název** |\n| **2\\. Kód** (kódy by měly být navázány na obory vzdělání a výsledky učení) |\n| **2a) Kategorie vzdělání** - v případě, že nebude součástí kódu |\n| **3\\. Typ vyučovací jednotky** (modul, předmět, stáž apod.) |\n| **4\\. Délka** (počet hodin - dělitelný čtyřmi (optimální modul 16, 32 hodin = týden výuky) |\n| **5\\. Platnost** (datum, od kterého platí) |\n| **6\\. Vstupní předpoklady** (vymezení požadované úrovně vstupních vědomostí a dovedností, které jsou předpokladem úspěšného studia) |\n|     |\n| **B. JÁDRO VYUČOVACÍ JEDNOTKY** |\n| **1\\. Charakteristika** (stručná anotace popisující obecné cíle a pojetí) |\n| **2\\. Očekávané výsledky učení a jejich indikátory (převzaté z RVP nebo dále konkretizované)** |\n| **3\\. Podpora rozvoje klíčových kompetencí a základních gramotností** (které klíčové kompetence jsou v rozvíjeny) |\n| **4\\. Obsah vzdělávání** (rozpis učiva) |\n| **5\\. Vzdělávací strategie** (strategie výuky, resp. učební činnosti žáků, které jsou doporučené pro dosažení výsledků) |\n|     |\n| **C. VÝSTUPNÍ ČÁST** |\n| **1\\. Způsob ověřování dosažených výsledků** (ve vazbě na jednotlivé výsledky učení) |\n| **2\\. Kritéria hodnocení** (co znamená splnění výsledků učení, kdy je splněna celá vyučovací jednotka, kritéria pro známky, příp. procentuální, slovní hodnocení) |\n| **3\\. Doporučená studijní literatura, odkazy na ilustrační zdroje** |\n| **4\\. Poznámky** |\n\n**Soulad OVU RVP a ŠVP**\n\nTento soulad je předmětem zjišťování. Soulad nastává, jestliže jsou očekávané výsledky učení z jednotlivých vzdělávacích oblastí RVP **obsaženy** ve vyučovacích předmětech/ vzdělávacích modulech ŠVP jednotlivých škol, tzn. že v ŠVP se objevuje jejich formulace buď v doslovném nebo podobném znění v jednom nebo více vyučovacích předmětech/ vzdělávacích modulech.\n\n_Příklad souladu:_\n\nRVP ŠVP - komunikace a marketing (SŠ obchodní Č.\n\n| **2** | **řídí realizaci jednoduchého projektu** |\n| --- | --- |\n| naplánuje aktivity projektu |\n| navrhne rozpočet projektu vzhledem k navrženým aktivitám |\n| stanoví základní ukazatele a sleduje jejich naplňování |\n| vede projektový tým |\n| uvede, jak by řešil krizové situace v projektu |\n| vyhodnotí úspěšnost projektu |\n\nKNOWLEDGE  {Porovnání RVP a ŠVP - postup}\n\n\n# AUDITNÍ PROTOKOL ŠVP-RVP\n\n# (POPIS KONTROLNÍHO ALGORITMU)\n\nMetodika je určena pro **Kvantifikaci Shody** školního vzdělávacího programu (ŠVP) s Rámcovým vzdělávacím programem (RVP).\n\n## FÁZE 1: VALIDACE DOKUMENTACE\n\n**Cíl:** Ověřit platnost, aktuálnost a strukturu zdrojových dokumentů.\n\n- **RVP Verifikace:** Otevřít aktuální verzi RVP (např. RVP ZV/G/SOŠ).\n- **Typová shoda:** Ověřit, že RVP se vztahuje k danému typu školy.\n- **ŠVP Dimenze:** Identifikovat a izolovat relevantní části ŠVP: Profil absolventa, Klíčové kompetence (KK), Vzdělávací oblasti (VO), případně Učební plán (UP).\n- **Verzování:** Potvrdit, že obě verze (RVP a ŠVP) jsou nejnovější a platné (včetně dodatků RVP).\n\n## FÁZE 2: DATABÁZOVÉ MAPOVÁNÍ VÝSTUPŮ (MASTER MATICE)\n\n**Cíl:** Vytvořit systémovou databázi pro křížové porovnání všech povinných komponent RVP se ŠVP.\n\n- **Dekompozice RVP:** Rozložit RVP na základní povinné komponenty: Klíčové kompetence, Vzdělávací oblasti a obory, Očekávané výstupy (OVU), Průřezová témata (PT).\n- **Přiřazovací mapa:** Vytvořit hlavní kontrolní matici (Master Matice) pro záznam vazeb.\n\n| Oblast RVP | Výstup RVP (OVU) | Odpovídající Část ŠVP (Předmět/Ročník) | Konkrétní Tématický Celek v ŠVP | Stav Shody (Protokol) |\n| --- | --- | --- | --- | --- |\n| ... | ... | ... | ... | ... |\n| --- | --- | --- | --- | --- |\n\n## FÁZE 3: ALGORITMICKÁ KONTROLA POKRYTÍ A HLOUBKY\n\n**Cíl:** Posoudit, zda každý povinný výstup RVP je adekvátně reflektován v obsahu ŠVP, a přidělit bodovou hodnotu pro kvantifikaci.\n\n- **Audit OVU:** Projít každý jednotlivý Očekávaný výstup (OVU) z RVP.\n- **Kódování stavu a bodování:** U každého OVU v matici označit stav pokrytí dle následujícího schématu:\n\n| Kód (Protokol) | Popis (Kvalitativní zjištění) | Bodová hodnota (Kvantifikace) |\n| --- | --- | --- |\n| ✅   | Plná shoda (Výstup pokryt v plném rozsahu, odpovídající úrovni RVP) | 1,0 |\n| --- | --- | --- |\n| ⚠️  | Částečná shoda (Formální pokrytí, omezený rozsah, chybná návaznost) | 0,5 |\n| --- | --- | --- |\n| ❌   | Absence (Výstup zcela chybí v obsahu ŠVP) | 0,0 |\n| --- | --- | --- |\n\n- **Defektologie ŠVP:** Identifikovat a zaznamenat deficity ŠVP: Chybějící výstupy (❌), Sémantické překryvy, Přetížení obsahu.\n- **Kvalitativní posun:** Ověřit, zda je formulace výstupů v ŠVP **aktivní, měřitelná a v souladu** s úrovní RVP.\n\n## FÁZE 4: STRUKTURÁLNÍ VERIFIKACE NÁVAZNOSTI (VERTIKÁLA/HORIZONTÁLA)\n\n**Cíl:** Zkontrolovat logickou posloupnost a provázanost učiva v rámci ŠVP.\n\n- **Vertikální Kontrola:** Ověřit posloupnost OVU a učiva uvnitř jednoho předmětu/oblasti (postup od jednodušších ke složitějším konceptům napříč ročníky).\n- **Horizontální Kontrola:** Zkontrolovat logické provázání napříč vzdělávacími oblastmi a předměty (např. fyzika ↔ matematika).\n- **PT Integrace:** Audit reálné integrace Průřezových témat (PT) do konkrétních částí obsahu, metod a projektů.\n\n## FÁZE 5: ANALÝZA ŠKOLNÍ PROFILACE A ROZŠÍŘENÍ RVP\n\n**Cíl:** Validovat, že profilace školy je **v souladu** s RVP a nejedná se o **rozpor**.\n\n- **Nekonfliktnost:** Porovnat definovaný Profil absolventa školy s Klíčovými kompetencemi RVP. Profil ŠVP musí RVP rozvíjet, nikoli mu odporovat.\n- **Modularita:** Zkontrolovat, zda volitelné předměty a rozšiřující moduly logicky navazují na vzdělávací oblasti RVP.\n- **Implementace specializace:** Popisně uvést, jak je školní profilace (např. STEM zaměření, projektová výuka) integrována do OVU a kompetencí definovaných RVP.\n\n## FÁZE 6: GENERÁTOR ZÁVĚREČNÉ ZPRÁVY A KVANTIFIKACE\n\n**Cíl:** Syntetizovat výsledky, kvantifikovat soulad a generovat závazné návrhy na korekce.\n\n### 6.1 Kvantifikace Souladu\n\nVypočítat Index shody (IS) na základě bodového hodnocení (Fáze 3):\n\n### 6.2 Interpretace Indexu Shody (IS)\n\nKlasifikace souladu pro standardizované vyhodnocení:\n\n| Interval IS | Klasifikace souladu | Popis |\n| --- | --- | --- |\n| 95-100 % | Výborný soulad | ŠVP plně odpovídá RVP, pouze stylistické nebo formální rozdíly. |\n| --- | --- | --- |\n| 85-94 % | Dobrá shoda | ŠVP pokrývá všechny klíčové výstupy, menší korekce nutné. |\n| --- | --- | --- |\n| 70-84 % | Částečná shoda | Významné nedostatky v některých oblastech, nutná revize obsahu. |\n| --- | --- | --- |\n| < 70 % | Kritická neshoda | ŠVP neplní rámcové požadavky, ohrožuje legislativní soulad. |\n| --- | --- | --- |\n\n### 6.3 Doplňkové Indexy\n\nVypočítat následující doplňkové indexy pro detailní kvalitativní analýzu:\n\n- **Index kompetenčního souladu (IKS):** Poměr pokrytí klíčových kompetencí RVP v ŠVP.\n- **Index průřezové integrace (IPI):** Míra reálné integrace průřezových témat do výuky.\n- **Index hloubky pokrytí (IHP):** Procento výstupů, které jsou v ŠVP rozvedeny na konkrétní výukové cíle (měřitelné, aktivní formulace).\n- **Index profilové rozšiřitelnosti (IPR):** Kolik rozšiřujících nebo profilových výstupů přesahuje rámec RVP, aniž by narušily jeho strukturu.\n\n### 6.4 Vizuální výstupy\n\nZajistit generování následujících vizualizací pro Závěrečnou zprávu:\n\n- Graf pokrytí po vzdělávacích oblastech (Sloupcový graf IS pro VO).\n- Pavoukový diagram Klíčových kompetencí (RVP vs. ŠVP).\n- Mapa defektů (Vizualizace ❌ a ⚠️ výstupů).\n\n### 6.5 Struktura Závěrečné Zprávy\n\nZpráva musí být strukturována dle standardizovaného formátu:\n\n| Oddíl | Obsah |\n| --- | --- |\n| A. Identifikace | Název školy, IZO, typ školy, datum revize, zpracovatel, verze ŠVP a RVP. |\n| --- | --- |\n| B. Shrnutí výsledků | Celkový Index Shody (IS), hlavní závěry a doporučení. |\n| --- | --- |\n| C. Kvantitativní analýza | Přehled IS v % dle kategorií OVU / VO / kompetencí. |\n| --- | --- |\n| D. Kvalitativní analýza | Slovní zhodnocení kvality souladu (formulace, obtížnost, integrace PT). |\n| --- | --- |\n| E. Rizikové oblasti | Přehled nalezených defektů (chybějící OVU, přetížení, formální shoda). |\n| --- | --- |\n| F. Návrhy opatření (Korekční plán) | Přesné návrhy změn - **Co, Kde, Kdo** má upravit, včetně termínu. |\n| --- | --- |\n| G. Přílohy | Master Matice (Fáze 2-3), revizní tabulka, výstupní grafy a metriky. |\n| --- | --- |\n\n\n\n\n.",resultingParameterName:"result",dependentParameterNames:[]}],personas:[],preparations:[{id:1,promptbookVersion:"0.103.0-0",usage:{price:{value:0},input:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}},output:{tokensCount:{value:0},charactersCount:{value:0},wordsCount:{value:0},sentencesCount:{value:0},linesCount:{value:0},paragraphsCount:{value:0},pagesCount:{value:0}}}}],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"Asistent pro LŠVP\n\nPERSONA Jsi asistent pro RVP Lyceum v rámci Národního pedagogického institutu České Republiky\nMETA IMAGE https://edulk.cz/getFile/id:475818/type:large/02%20zna%C4%8Dka%20npi.jpg\nRULE Pokud jsi nejsi jistý, napiš nevím\nKNOWLEDGE ./241129_Lyceum_final.pdf\nCONTEXT Obecně dokážeš řešit libovolné ŠVP, aktuálně řešíš {Školní vzdělávací program LYCEUM}\nRULE Z {Porovnání RVP a ŠVP - postup} je nejdůležitější fáze 3\nKNOWLEDGE {Školní vzdělávací program LYCEUM}  ./ŠVP Lyceum - Finance v digitální době.pdf\nKNOWLEDGE @Slovník\n\n**Interní slovník - RVP/ŠVP**\n\n**RVP**\n\nRámcový vzdělávací program pro obor vzdělání Lyceum je dokument na národní úrovni, který formuluje požadavky na školní vzdělávací programy ve formě především očekávaných výsledků učení, kterých mají žáci absolvováním tohoto programu na dané škole dosáhnout.\n\n**ŠVP**\n\nŠkolní vzdělávací program pro obor vzdělání Lyceum je dokument každé jednotlivé školy, který popisuje v jakých vyučovacích předmětech/ vzdělávacích modulech a v jakých ročnících budou požadované očekávané výsledky učení naplněny. Zároveň formuluje další očekávané výsledky učení, které naplňují disponibilní část vyučovacího času určeného RVP pro tento obor vzdělání.\n\n**Očekávaný výsledek učení (OVU)**\n\nVyjadřuje jednotlivý požadavek na to, co mají žáci umět na konci vzdělávacího programu, tzn. jejich požadované kompetence. Je vyjádřen formulací, která je uvozena činnostním slovesem a dále obsahuje předmět této činnosti. Formulace je konkretizována resp. doplněna zpravidla formou odrážek vymezením dílčích znalostí, dovedností, postojů, jejichž splnění je předpokladem dosažení OVU jako celku.\n\n_Příklad:_\n\n<div class=\"joplin-table-wrapper\"><table><tbody><tr><th><p><strong>Žák/žákyně řídí realizaci jednoduchého projektu</strong></p></th></tr><tr><td><ul><li>naplánuje aktivity projektu</li></ul></td></tr><tr><td><ul><li>navrhne rozpočet projektu vzhledem k navrženým aktivitám</li></ul></td></tr><tr><td><ul><li>stanoví základní ukazatele a sleduje jejich naplňování</li></ul></td></tr><tr><td><ul><li>vede projektový tým</li></ul></td></tr><tr><td><ul><li>uvede, jak by řešil krizové situace v projektu</li></ul></td></tr><tr><td><ul><li>vyhodnotí úspěšnost projektu</li></ul></td></tr></tbody></table></div>\n\n**Vzdělávací oblasti**\n\nOčekávané výsledky učení jsou v **_RVP členěny do 4 vzdělávacích oblastí_**, které tvoří společný všeobecně vzdělávací základ:\n\n- Osobnostní rozvoj, vzdělávání ke zdraví, bezpečí a produktivnímu pracovnímu životu (kariéře)\n- Komunikační a jazykové vzdělávání\n- Aplikované vzdělávání STEM (Science, Technology, Engeneering, Math), tj. přírodní vědy, informatika, technika, matematika\n- Prakticky orientované vzdělávání společenskovědní a humanitní\n\nKaždá vzdělávací oblast se dále člení na okruhy, v jejichž rámci jsou OVU samostatně číslované.\n\n<div class=\"joplin-table-wrapper\"><table><tbody><tr><th rowspan=\"21\"><ul><li>Prakticky orientované vzdělávání společenskovědní a humanitní</li></ul></th><th rowspan=\"21\"><p><strong>Člověk, ekonomie a podnikání</strong></p></th><th rowspan=\"7\"><p><strong>1</strong></p></th><th><p><strong>zpracuje podklady související s podnikáním</strong></p></th></tr><tr><td><p>připraví podnikatelský záměr</p></td></tr><tr><td><p>sestaví zakladatelský rozpočet</p></td></tr><tr><td><p>zkalkuluje cenu zboží nebo služby</p></td></tr><tr><td><p>vysvětlí na příkladu základní povinnosti podnikatele vůči státu a zaměstnancům</p></td></tr><tr><td><p>vede daňovou evidenci</p></td></tr><tr><td><p>vysvětlí na příkladech etiku v podnikání</p></td></tr><tr><td rowspan=\"7\"><p><strong>2</strong></p></td><td><p><strong>řídí realizaci jednoduchého projektu</strong></p></td></tr><tr><td><p>naplánuje aktivity projektu</p></td></tr><tr><td><p>navrhne rozpočet projektu vzhledem k navrženým aktivitám</p></td></tr><tr><td><p>stanoví základní ukazatele a sleduje jejich naplňování</p></td></tr><tr><td><p>vede projektový tým</p></td></tr><tr><td><p>uvede, jak by řešil krizové situace v projektu</p></td></tr><tr><td><p>vyhodnotí úspěšnost projektu</p></td></tr><tr><td rowspan=\"7\"><p><strong>3</strong></p></td><td><p><strong>aplikuje ekonomické teorie v osobním a profesním životě</strong></p></td></tr><tr><td><p>vysvětlí základní ekonomické otázky</p></td></tr><tr><td><p>vysvětí stanovení rovnovážné ceny na dokonalém i nedokonalém trhu</p></td></tr><tr><td><p>charakterizuje výrobní faktory a vysvětlí hranici produkčních možností a náklady obětované příležitosti</p></td></tr><tr><td><p>uvede nejdůležitější makroekonomické pojmy a vliv jejich výše na kvalitu života a podnikání v daném státě</p></td></tr><tr><td><p>vysvětlí podstatu inflace a její důsledky na finanční situaci obyvatel a na příkladu ukáže jak se bránit jejím nepříznivým důsledkům</p></td></tr><tr><td><p>uvede hlavní výhody a nevýhody mezinárodního obchodu a vliv ochranářských opatření na ekonomickou situaci dané země</p></td></tr><tr><td></td><td></td><td><p><strong>4</strong></p></td><td><p>Atd.</p></td></tr></tbody></table></div>\n\n**Vyučovací předmět / vzdělávací modul**\n\nOčekávané výsledky učení jsou v **ŠVP** členěny do vyučovacích předmětů nebo vzdělávacích modulů, které jsou dále zařazeny do jednoho nebo více ročníků 4letého studia. Vyučovací předmět / vzdělávací modul tvoří vyučovací jednotku, kde jsou očekávané výsledky učení dále rozpracovány pro potřeby výuky podle následující šablony\n\n| **A. VSTUPNÍ ČÁST** |\n| --- |\n| **1\\. Název** |\n| **2\\. Kód** (kódy by měly být navázány na obory vzdělání a výsledky učení) |\n| **2a) Kategorie vzdělání** - v případě, že nebude součástí kódu |\n| **3\\. Typ vyučovací jednotky** (modul, předmět, stáž apod.) |\n| **4\\. Délka** (počet hodin - dělitelný čtyřmi (optimální modul 16, 32 hodin = týden výuky) |\n| **5\\. Platnost** (datum, od kterého platí) |\n| **6\\. Vstupní předpoklady** (vymezení požadované úrovně vstupních vědomostí a dovedností, které jsou předpokladem úspěšného studia) |\n|     |\n| **B. JÁDRO VYUČOVACÍ JEDNOTKY** |\n| **1\\. Charakteristika** (stručná anotace popisující obecné cíle a pojetí) |\n| **2\\. Očekávané výsledky učení a jejich indikátory (převzaté z RVP nebo dále konkretizované)** |\n| **3\\. Podpora rozvoje klíčových kompetencí a základních gramotností** (které klíčové kompetence jsou v rozvíjeny) |\n| **4\\. Obsah vzdělávání** (rozpis učiva) |\n| **5\\. Vzdělávací strategie** (strategie výuky, resp. učební činnosti žáků, které jsou doporučené pro dosažení výsledků) |\n|     |\n| **C. VÝSTUPNÍ ČÁST** |\n| **1\\. Způsob ověřování dosažených výsledků** (ve vazbě na jednotlivé výsledky učení) |\n| **2\\. Kritéria hodnocení** (co znamená splnění výsledků učení, kdy je splněna celá vyučovací jednotka, kritéria pro známky, příp. procentuální, slovní hodnocení) |\n| **3\\. Doporučená studijní literatura, odkazy na ilustrační zdroje** |\n| **4\\. Poznámky** |\n\n**Soulad OVU RVP a ŠVP**\n\nTento soulad je předmětem zjišťování. Soulad nastává, jestliže jsou očekávané výsledky učení z jednotlivých vzdělávacích oblastí RVP **obsaženy** ve vyučovacích předmětech/ vzdělávacích modulech ŠVP jednotlivých škol, tzn. že v ŠVP se objevuje jejich formulace buď v doslovném nebo podobném znění v jednom nebo více vyučovacích předmětech/ vzdělávacích modulech.\n\n_Příklad souladu:_\n\nRVP ŠVP - komunikace a marketing (SŠ obchodní Č.\n\n| **2** | **řídí realizaci jednoduchého projektu** |\n| --- | --- |\n| naplánuje aktivity projektu |\n| navrhne rozpočet projektu vzhledem k navrženým aktivitám |\n| stanoví základní ukazatele a sleduje jejich naplňování |\n| vede projektový tým |\n| uvede, jak by řešil krizové situace v projektu |\n| vyhodnotí úspěšnost projektu |\n\nKNOWLEDGE  {Porovnání RVP a ŠVP - postup}\n\n\n# AUDITNÍ PROTOKOL ŠVP-RVP\n\n# (POPIS KONTROLNÍHO ALGORITMU)\n\nMetodika je určena pro **Kvantifikaci Shody** školního vzdělávacího programu (ŠVP) s Rámcovým vzdělávacím programem (RVP).\n\n## FÁZE 1: VALIDACE DOKUMENTACE\n\n**Cíl:** Ověřit platnost, aktuálnost a strukturu zdrojových dokumentů.\n\n- **RVP Verifikace:** Otevřít aktuální verzi RVP (např. RVP ZV/G/SOŠ).\n- **Typová shoda:** Ověřit, že RVP se vztahuje k danému typu školy.\n- **ŠVP Dimenze:** Identifikovat a izolovat relevantní části ŠVP: Profil absolventa, Klíčové kompetence (KK), Vzdělávací oblasti (VO), případně Učební plán (UP).\n- **Verzování:** Potvrdit, že obě verze (RVP a ŠVP) jsou nejnovější a platné (včetně dodatků RVP).\n\n## FÁZE 2: DATABÁZOVÉ MAPOVÁNÍ VÝSTUPŮ (MASTER MATICE)\n\n**Cíl:** Vytvořit systémovou databázi pro křížové porovnání všech povinných komponent RVP se ŠVP.\n\n- **Dekompozice RVP:** Rozložit RVP na základní povinné komponenty: Klíčové kompetence, Vzdělávací oblasti a obory, Očekávané výstupy (OVU), Průřezová témata (PT).\n- **Přiřazovací mapa:** Vytvořit hlavní kontrolní matici (Master Matice) pro záznam vazeb.\n\n| Oblast RVP | Výstup RVP (OVU) | Odpovídající Část ŠVP (Předmět/Ročník) | Konkrétní Tématický Celek v ŠVP | Stav Shody (Protokol) |\n| --- | --- | --- | --- | --- |\n| ... | ... | ... | ... | ... |\n| --- | --- | --- | --- | --- |\n\n## FÁZE 3: ALGORITMICKÁ KONTROLA POKRYTÍ A HLOUBKY\n\n**Cíl:** Posoudit, zda každý povinný výstup RVP je adekvátně reflektován v obsahu ŠVP, a přidělit bodovou hodnotu pro kvantifikaci.\n\n- **Audit OVU:** Projít každý jednotlivý Očekávaný výstup (OVU) z RVP.\n- **Kódování stavu a bodování:** U každého OVU v matici označit stav pokrytí dle následujícího schématu:\n\n| Kód (Protokol) | Popis (Kvalitativní zjištění) | Bodová hodnota (Kvantifikace) |\n| --- | --- | --- |\n| ✅   | Plná shoda (Výstup pokryt v plném rozsahu, odpovídající úrovni RVP) | 1,0 |\n| --- | --- | --- |\n| ⚠️  | Částečná shoda (Formální pokrytí, omezený rozsah, chybná návaznost) | 0,5 |\n| --- | --- | --- |\n| ❌   | Absence (Výstup zcela chybí v obsahu ŠVP) | 0,0 |\n| --- | --- | --- |\n\n- **Defektologie ŠVP:** Identifikovat a zaznamenat deficity ŠVP: Chybějící výstupy (❌), Sémantické překryvy, Přetížení obsahu.\n- **Kvalitativní posun:** Ověřit, zda je formulace výstupů v ŠVP **aktivní, měřitelná a v souladu** s úrovní RVP.\n\n## FÁZE 4: STRUKTURÁLNÍ VERIFIKACE NÁVAZNOSTI (VERTIKÁLA/HORIZONTÁLA)\n\n**Cíl:** Zkontrolovat logickou posloupnost a provázanost učiva v rámci ŠVP.\n\n- **Vertikální Kontrola:** Ověřit posloupnost OVU a učiva uvnitř jednoho předmětu/oblasti (postup od jednodušších ke složitějším konceptům napříč ročníky).\n- **Horizontální Kontrola:** Zkontrolovat logické provázání napříč vzdělávacími oblastmi a předměty (např. fyzika ↔ matematika).\n- **PT Integrace:** Audit reálné integrace Průřezových témat (PT) do konkrétních částí obsahu, metod a projektů.\n\n## FÁZE 5: ANALÝZA ŠKOLNÍ PROFILACE A ROZŠÍŘENÍ RVP\n\n**Cíl:** Validovat, že profilace školy je **v souladu** s RVP a nejedná se o **rozpor**.\n\n- **Nekonfliktnost:** Porovnat definovaný Profil absolventa školy s Klíčovými kompetencemi RVP. Profil ŠVP musí RVP rozvíjet, nikoli mu odporovat.\n- **Modularita:** Zkontrolovat, zda volitelné předměty a rozšiřující moduly logicky navazují na vzdělávací oblasti RVP.\n- **Implementace specializace:** Popisně uvést, jak je školní profilace (např. STEM zaměření, projektová výuka) integrována do OVU a kompetencí definovaných RVP.\n\n## FÁZE 6: GENERÁTOR ZÁVĚREČNÉ ZPRÁVY A KVANTIFIKACE\n\n**Cíl:** Syntetizovat výsledky, kvantifikovat soulad a generovat závazné návrhy na korekce.\n\n### 6.1 Kvantifikace Souladu\n\nVypočítat Index shody (IS) na základě bodového hodnocení (Fáze 3):\n\n### 6.2 Interpretace Indexu Shody (IS)\n\nKlasifikace souladu pro standardizované vyhodnocení:\n\n| Interval IS | Klasifikace souladu | Popis |\n| --- | --- | --- |\n| 95-100 % | Výborný soulad | ŠVP plně odpovídá RVP, pouze stylistické nebo formální rozdíly. |\n| --- | --- | --- |\n| 85-94 % | Dobrá shoda | ŠVP pokrývá všechny klíčové výstupy, menší korekce nutné. |\n| --- | --- | --- |\n| 70-84 % | Částečná shoda | Významné nedostatky v některých oblastech, nutná revize obsahu. |\n| --- | --- | --- |\n| < 70 % | Kritická neshoda | ŠVP neplní rámcové požadavky, ohrožuje legislativní soulad. |\n| --- | --- | --- |\n\n### 6.3 Doplňkové Indexy\n\nVypočítat následující doplňkové indexy pro detailní kvalitativní analýzu:\n\n- **Index kompetenčního souladu (IKS):** Poměr pokrytí klíčových kompetencí RVP v ŠVP.\n- **Index průřezové integrace (IPI):** Míra reálné integrace průřezových témat do výuky.\n- **Index hloubky pokrytí (IHP):** Procento výstupů, které jsou v ŠVP rozvedeny na konkrétní výukové cíle (měřitelné, aktivní formulace).\n- **Index profilové rozšiřitelnosti (IPR):** Kolik rozšiřujících nebo profilových výstupů přesahuje rámec RVP, aniž by narušily jeho strukturu.\n\n### 6.4 Vizuální výstupy\n\nZajistit generování následujících vizualizací pro Závěrečnou zprávu:\n\n- Graf pokrytí po vzdělávacích oblastech (Sloupcový graf IS pro VO).\n- Pavoukový diagram Klíčových kompetencí (RVP vs. ŠVP).\n- Mapa defektů (Vizualizace ❌ a ⚠️ výstupů).\n\n### 6.5 Struktura Závěrečné Zprávy\n\nZpráva musí být strukturována dle standardizovaného formátu:\n\n| Oddíl | Obsah |\n| --- | --- |\n| A. Identifikace | Název školy, IZO, typ školy, datum revize, zpracovatel, verze ŠVP a RVP. |\n| --- | --- |\n| B. Shrnutí výsledků | Celkový Index Shody (IS), hlavní závěry a doporučení. |\n| --- | --- |\n| C. Kvantitativní analýza | Přehled IS v % dle kategorií OVU / VO / kompetencí. |\n| --- | --- |\n| D. Kvalitativní analýza | Slovní zhodnocení kvality souladu (formulace, obtížnost, integrace PT). |\n| --- | --- |\n| E. Rizikové oblasti | Přehled nalezených defektů (chybějící OVU, přetížení, formální shoda). |\n| --- | --- |\n| F. Návrhy opatření (Korekční plán) | Přesné návrhy změn - **Co, Kde, Kdo** má upravit, včetně termínu. |\n| --- | --- |\n| G. Přílohy | Master Matice (Fáze 2-3), revizní tabulka, výstupní grafy a metriky. |\n| --- | --- |\n\n\n\n\n.\n"}],sourceFile:"./books/examples/lsvp-asistent.book"}];
+    var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge from Markdown\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book`\n-   INPUT PARAMETER `{knowledgeContent}` Markdown document content\n-   OUTPUT PARAMETER `{knowledgePieces}` The knowledge JSON object\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}\n```\n\n`-> {knowledgePieces}`\n"}],sourceFile:"./books/prepare-knowledge-from-markdown.book"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Keywords\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-keywords.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{keywords}` Keywords separated by comma\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}\n```\n\n`-> {keywords}`\n"}],sourceFile:"./books/prepare-knowledge-keywords.book"},{title:"Prepare Knowledge-piece Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge-piece Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-title.book`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{title}` The title of the document\n\n## Knowledge\n\n-   EXPECT MIN 1 WORD\n-   EXPECT MAX 8 WORDS\n\n```markdown\nYou are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-knowledge-title.book"},{title:"Prepare Persona",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book",formfactorName:"GENERIC",parameters:[{name:"availableModels",description:"List of available model names together with their descriptions as JSON",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelsRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n```json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n```\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n```json\n{availableModels}\n```\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",resultingParameterName:"modelsRequirements",format:"JSON",dependentParameterNames:["availableModels","personaDescription"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Persona\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-persona.book`\n-   INPUT PARAMETER `{availableModels}` List of available model names together with their descriptions as JSON\n-   INPUT PARAMETER `{personaDescription}` Description of the persona\n-   OUTPUT PARAMETER `{modelsRequirements}` Specific requirements for the model\n\n## Make modelRequirements\n\n-   FORMAT JSON\n\n```markdown\nYou are an experienced AI engineer, you need to find the best models for virtual assistants:\n\n## Example\n\n\\`\\`\\`json\n[\n  {\n  \"modelName\": \"gpt-4o\",\n  \"systemMessage\": \"You are experienced AI engineer and helpful assistant.\",\n  \"temperature\": 0.7\n  },\n  {\n    \"modelName\": \"claude-3-5-sonnet\",\n    \"systemMessage\": \"You are a friendly and knowledgeable chatbot.\",\n    \"temperature\": 0.5\n  }\n]\n\\`\\`\\`\n\n## Instructions\n\n-   Your output format is JSON array\n-   Sort best-fitting models first\n-   Omit any models that are not suitable\n-   Write just the JSON, no other text should be present\n-   Array contain items with following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nHere are the available models:\n\n\\`\\`\\`json\n{availableModels}\n\\`\\`\\`\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}\n```\n\n`-> {modelsRequirements}`\n"}],sourceFile:"./books/prepare-persona.book"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-title.book",formfactorName:"GENERIC",parameters:[{name:"book",description:"The book to prepare the title for",isInput:true,isOutput:false},{name:"title",description:"Best title for the book",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-title",title:"Make title",content:"Make best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}",resultingParameterName:"title",expectations:{words:{min:1,max:8},lines:{min:1,max:1}},dependentParameterNames:["book"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-title.book`\n-   INPUT PARAMETER `{book}` The book to prepare the title for\n-   OUTPUT PARAMETER `{title}` Best title for the book\n\n## Make title\n\n-   EXPECT MIN 1 Word\n-   EXPECT MAX 8 Words\n-   EXPECT EXACTLY 1 Line\n\n```markdown\nMake best title for given text which describes the workflow:\n\n## Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear - Write maximum ideally 2 words, maximum 5 words\n-   Title starts with emoticon\n-   Title should not mention the input and output of the workflow but the main purpose of the workflow\n    _For example, not \"✍ Convert Knowledge-piece to title\" but \"✍ Title\"_\n\n## The workflow\n\n> {book}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-title.book"}];
 
     /**
      * Checks if value is valid email
@@ -3268,6 +3327,8 @@
      * Function `validatePipelineString` will validate the if the string is a valid pipeline string
      * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param {string} pipelineString the candidate for a pipeline string
      * @returns {PipelineString} the same string as input, but validated as valid
      * @throws {ParseError} if the string is not a valid pipeline string
@@ -3515,7 +3576,7 @@
      * Library of pipelines that groups together pipelines for an application.
      * This implementation is a very thin wrapper around the Array / Map of pipelines.
      *
-     * @private internal function of `createCollectionFromJson`, use `createCollectionFromJson` instead
+     * @private internal function of `createPipelineCollectionFromJson`, use `createPipelineCollectionFromJson` instead
      * @see https://github.com/webgptorg/pipeline#pipeline-collection
      */
     class SimplePipelineCollection {
@@ -3525,14 +3586,14 @@
          * @param pipelines Array of pipeline JSON objects to include in the collection
          *
          * Note: During the construction logic of all pipelines are validated
-         * Note: It is not recommended to use this constructor directly, use `createCollectionFromJson` *(or other variant)* instead
+         * Note: It is not recommended to use this constructor directly, use `createPipelineCollectionFromJson` *(or other variant)* instead
          */
         constructor(...pipelines) {
             this.collection = new Map();
             for (const pipeline of pipelines) {
                 // TODO: [👠] DRY
                 if (pipeline.pipelineUrl === undefined) {
-                    throw new PipelineUrlError(spaceTrim.spaceTrim(`
+                    throw new PipelineUrlError(spaceTrim$1.spaceTrim(`
                         Pipeline with name "${pipeline.title}" does not have defined URL
 
                         File:
@@ -3554,7 +3615,7 @@
                     pipelineJsonToString(unpreparePipeline(pipeline)) !==
                         pipelineJsonToString(unpreparePipeline(this.collection.get(pipeline.pipelineUrl)))) {
                     const existing = this.collection.get(pipeline.pipelineUrl);
-                    throw new PipelineUrlError(spaceTrim.spaceTrim(`
+                    throw new PipelineUrlError(spaceTrim$1.spaceTrim(`
                         Pipeline with URL ${pipeline.pipelineUrl} is already in the collection 🍎
 
                         Conflicting files:
@@ -3586,13 +3647,13 @@
             const pipeline = this.collection.get(url);
             if (!pipeline) {
                 if (this.listPipelines().length === 0) {
-                    throw new NotFoundError(spaceTrim.spaceTrim(`
+                    throw new NotFoundError(spaceTrim$1.spaceTrim(`
                             Pipeline with url "${url}" not found
 
                             No pipelines available
                         `));
                 }
-                throw new NotFoundError(spaceTrim.spaceTrim((block) => `
+                throw new NotFoundError(spaceTrim$1.spaceTrim((block) => `
                         Pipeline with url "${url}" not found
 
                         Available pipelines:
@@ -3613,16 +3674,16 @@
     }
 
     /**
-     * Creates PipelineCollection from array of PipelineJson or PipelineString
+     * Creates `PipelineCollection` from array of PipelineJson or PipelineString
      *
-     * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
+     * Note: Functions `pipelineCollectionToJson` and `createPipelineCollectionFromJson` are complementary
      * Note: Syntax, parsing, and logic consistency checks are performed on all sources during build
      *
      * @param promptbookSources
      * @returns PipelineCollection
      * @public exported from `@promptbook/core`
      */
-    function createCollectionFromJson(...promptbooks) {
+    function createPipelineCollectionFromJson(...promptbooks) {
         return new SimplePipelineCollection(...promptbooks);
     }
 
@@ -4000,6 +4061,7 @@
         return new MultipleLlmExecutionTools(title || 'Multiple LLM Providers joined by `joinLlmExecutionTools`', ...llmExecutionTools);
     }
     /**
+     * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
      * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
      */
 
@@ -4016,6 +4078,7 @@
         return llmTools;
     }
     /**
+     * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
      * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
      */
 
@@ -4031,7 +4094,7 @@
             throw new MissingToolsError('LLM tools are required for preparing persona');
         }
         // TODO: [🌼] In future use `ptbk make` and made getPipelineCollection
-        const collection = createCollectionFromJson(...PipelineCollection);
+        const collection = createPipelineCollectionFromJson(...PipelineCollection);
         const preparePersonaExecutor = createPipelineExecutor({
             pipeline: await collection.getPipelineByUrl('https://promptbook.studio/promptbook/prepare-persona.book'),
             tools,
@@ -4597,6 +4660,8 @@
     /**
      * Converts a given text to kebab-case format.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param text The text to be converted.
      * @returns The kebab-case formatted string.
      * @example 'hello-world'
@@ -4752,6 +4817,8 @@
     /**
      * Converts a title string into a normalized name.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param value The title string to be converted to a name.
      * @returns A normalized name derived from the input title.
      * @example 'Hello World!' -> 'hello-world'
@@ -5140,7 +5207,7 @@
             if (task.taskType === 'PROMPT_TASK' &&
                 knowledgePiecesCount > 0 &&
                 !dependentParameterNames.includes('knowledge')) {
-                preparedContent = spaceTrim.spaceTrim(`
+                preparedContent = spaceTrim$1.spaceTrim(`
                     {content}
 
                     ## Knowledge
@@ -5226,7 +5293,7 @@
         let title = pipeline.title;
         if (title === undefined || title === '' || title === DEFAULT_BOOK_TITLE) {
             // TODO: [🌼] In future use `ptbk make` and made getPipelineCollection
-            const collection = createCollectionFromJson(...PipelineCollection);
+            const collection = createPipelineCollectionFromJson(...PipelineCollection);
             const prepareTitleExecutor = createPipelineExecutor({
                 pipeline: await collection.getPipelineByUrl('https://promptbook.studio/promptbook/prepare-title.book'),
                 tools,
@@ -5453,7 +5520,7 @@
         }
         catch (error) {
             assertsError(error);
-            throw new ParseError(spaceTrim.spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                     Can not extract variables from the script
                     ${block(error.stack || error.message)}
 
@@ -6155,10 +6222,13 @@
      * @public exported from `@promptbook/utils`
      */
     function countLines(text) {
+        if (text === '') {
+            return 0;
+        }
         text = text.replace('\r\n', '\n');
         text = text.replace('\r', '\n');
         const lines = text.split('\n');
-        return lines.reduce((count, line) => count + Math.ceil(line.length / CHARACTERS_PER_STANDARD_LINE), 0);
+        return lines.reduce((count, line) => count + Math.max(Math.ceil(line.length / CHARACTERS_PER_STANDARD_LINE), 1), 0);
     }
     /**
      * TODO: [🥴] Implement counting in formats - like JSON, CSV, XML,...
@@ -6283,6 +6353,8 @@
      * This function provides a common abstraction for result validation that can be used
      * by both execution logic and caching logic to ensure consistency.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param options - The validation options including result string, expectations, and format
      * @returns Validation result with processed string and validity status
      * @private internal function of `createPipelineExecutor` and `cacheLlmTools`
@@ -6302,7 +6374,7 @@
                         }
                         catch (error) {
                             keepUnused(error);
-                            throw new ExpectError(spaceTrim.spaceTrim((block) => `
+                            throw new ExpectError(spaceTrim$1.spaceTrim((block) => `
                                     Expected valid JSON string
 
                                     The expected JSON text:
@@ -6351,7 +6423,7 @@
      */
     async function executeAttempts(options) {
         const { jokerParameterNames, priority, maxAttempts, // <- Note: [💂]
-        preparedContent, parameters, task, preparedPipeline, tools, $executionReport, pipelineIdentification, maxExecutionAttempts, onProgress, } = options;
+        preparedContent, parameters, task, preparedPipeline, tools, $executionReport, pipelineIdentification, maxExecutionAttempts, onProgress, logLlmCall, } = options;
         const $ongoingTaskResult = {
             $result: null,
             $resultString: null,
@@ -6365,7 +6437,7 @@
             const jokerParameterName = jokerParameterNames[jokerParameterNames.length + attemptIndex];
             // TODO: [🧠][🍭] JOKERS, EXPECTATIONS, POSTPROCESSING and FOREACH
             if (isJokerAttempt && !jokerParameterName) {
-                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Joker not found in attempt ${attemptIndex}
 
                         ${block(pipelineIdentification)}
@@ -6376,7 +6448,7 @@
             $ongoingTaskResult.$expectError = null;
             if (isJokerAttempt) {
                 if (parameters[jokerParameterName] === undefined) {
-                    throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                    throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                             Joker parameter {${jokerParameterName}} not defined
 
                             ${block(pipelineIdentification)}
@@ -6434,7 +6506,7 @@
                                         $ongoingTaskResult.$resultString = $ongoingTaskResult.$completionResult.content;
                                         break variant;
                                     case 'EMBEDDING':
-                                        throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                        throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                                 Embedding model can not be used in pipeline
 
                                                 This should be catched during parsing
@@ -6445,7 +6517,7 @@
                                         break variant;
                                     // <- case [🤖]:
                                     default:
-                                        throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                        throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                                 Unknown model variant "${task.modelRequirements.modelVariant}"
 
                                                 ${block(pipelineIdentification)}
@@ -6456,14 +6528,14 @@
                             break;
                         case 'SCRIPT_TASK':
                             if (arrayableToArray(tools.script).length === 0) {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         No script execution tools are available
 
                                         ${block(pipelineIdentification)}
                                     `));
                             }
                             if (!task.contentLanguage) {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         Script language is not defined for SCRIPT TASK "${task.name}"
 
                                         ${block(pipelineIdentification)}
@@ -6494,7 +6566,7 @@
                                 throw $ongoingTaskResult.$scriptPipelineExecutionErrors[0];
                             }
                             else {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         Script execution failed ${$ongoingTaskResult.$scriptPipelineExecutionErrors.length}x
 
                                         ${block(pipelineIdentification)}
@@ -6508,7 +6580,7 @@
                             break taskType;
                         case 'DIALOG_TASK':
                             if (tools.userInterface === undefined) {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         User interface tools are not available
 
                                         ${block(pipelineIdentification)}
@@ -6526,7 +6598,7 @@
                             break taskType;
                         // <- case: [🅱]
                         default:
-                            throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                            throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                     Unknown execution type "${task.taskType}"
 
                                     ${block(pipelineIdentification)}
@@ -6599,14 +6671,10 @@
                 });
             }
             finally {
-                if (!isJokerAttempt &&
-                    task.taskType === 'PROMPT_TASK' &&
-                    $ongoingTaskResult.$prompt
-                //    <- Note:  [2] When some expected parameter is not defined, error will occur in templateParameters
-                //              In that case we don’t want to make a report about it because it’s not a llm execution error
-                ) {
-                    // TODO: [🧠] Maybe put other taskTypes into report
-                    $executionReport.promptExecutions.push({
+                if (!isJokerAttempt && task.taskType === 'PROMPT_TASK' && $ongoingTaskResult.$prompt) {
+                    // Note:  [2] When some expected parameter is not defined, error will occur in templateParameters
+                    //        In that case we don’t want to make a report about it because it’s not a llm execution error
+                    const executionPromptReport = {
                         prompt: {
                             ...$ongoingTaskResult.$prompt,
                             // <- TODO: [🧠] How to pick everyhing except `pipelineUrl`
@@ -6615,13 +6683,20 @@
                         error: $ongoingTaskResult.$expectError === null
                             ? undefined
                             : serializeError($ongoingTaskResult.$expectError),
-                    });
+                    };
+                    $executionReport.promptExecutions.push(executionPromptReport);
+                    if (logLlmCall) {
+                        logLlmCall({
+                            modelName: 'model' /* <- TODO: How to get model name from the report */,
+                            report: executionPromptReport,
+                        });
+                    }
                 }
             }
             if ($ongoingTaskResult.$expectError !== null && attemptIndex === maxAttempts - 1) {
                 // Note: Create a summary of all failures
                 const failuresSummary = $ongoingTaskResult.$failedResults
-                    .map((failure) => spaceTrim.spaceTrim((block) => {
+                    .map((failure) => spaceTrim$1.spaceTrim((block) => {
                     var _a, _b;
                     return `
                             Attempt ${failure.attemptIndex + 1}:
@@ -6631,14 +6706,14 @@
                             Result:
                             ${block(failure.result === null
                     ? 'null'
-                    : spaceTrim.spaceTrim(failure.result)
+                    : spaceTrim$1.spaceTrim(failure.result)
                         .split('\n')
                         .map((line) => `> ${line}`)
                         .join('\n'))}
                         `;
                 }))
                     .join('\n\n---\n\n');
-                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => {
+                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => {
                     var _a;
                     return `
                         LLM execution failed ${maxExecutionAttempts}x
@@ -6658,7 +6733,7 @@
             }
         }
         if ($ongoingTaskResult.$resultString === null) {
-            throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Something went wrong and prompt result is null
 
                     ${block(pipelineIdentification)}
@@ -6680,9 +6755,9 @@
      * @private internal utility of `createPipelineExecutor`
      */
     async function executeFormatSubvalues(options) {
-        const { task, jokerParameterNames, parameters, priority, csvSettings, onProgress, pipelineIdentification } = options;
+        const { task, jokerParameterNames, parameters, priority, csvSettings, onProgress, logLlmCall, pipelineIdentification, } = options;
         if (task.foreach === undefined) {
-            return /* not await */ executeAttempts(options);
+            return /* not await */ executeAttempts({ ...options, logLlmCall });
         }
         if (jokerParameterNames.length !== 0) {
             throw new UnexpectedError(spaceTrim__default["default"]((block) => `
@@ -6888,7 +6963,7 @@
                 },
                 content: task.content,
                 parameters,
-            };
+            }; /* <- Note: [🤛] */
             const taskEmbeddingResult = await llmTools.callEmbeddingModel(taskEmbeddingPrompt);
             const knowledgePiecesWithRelevance = preparedPipeline.knowledgePieces.map((knowledgePiece) => {
                 const { index } = knowledgePiece;
@@ -6964,7 +7039,7 @@
         // Note: Doublecheck that ALL reserved parameters are defined:
         for (const parameterName of RESERVED_PARAMETER_NAMES) {
             if (reservedParameters[parameterName] === undefined) {
-                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Reserved parameter {${parameterName}} is not defined
 
                         ${block(pipelineIdentification)}
@@ -6983,14 +7058,14 @@
      * @private internal utility of `createPipelineExecutor`
      */
     async function executeTask(options) {
-        const { currentTask, preparedPipeline, parametersToPass, tools, onProgress, $executionReport, pipelineIdentification, maxExecutionAttempts, maxParallelCount, csvSettings, isVerbose, rootDirname, cacheDirname, intermediateFilesStrategy, isAutoInstalled, isNotPreparedWarningSuppressed, } = options;
+        const { currentTask, preparedPipeline, parametersToPass, tools, onProgress, logLlmCall, $executionReport, pipelineIdentification, maxExecutionAttempts, maxParallelCount, csvSettings, isVerbose, rootDirname, cacheDirname, intermediateFilesStrategy, isAutoInstalled, isNotPreparedWarningSuppressed, } = options;
         const priority = preparedPipeline.tasks.length - preparedPipeline.tasks.indexOf(currentTask);
         // Note: Check consistency of used and dependent parameters which was also done in `validatePipeline`, but it’s good to doublecheck
         const usedParameterNames = extractParameterNamesFromTask(currentTask);
         const dependentParameterNames = new Set(currentTask.dependentParameterNames);
         // TODO: [👩🏾‍🤝‍👩🏻] Use here `mapAvailableToExpectedParameters`
         if (difference(union(difference(usedParameterNames, dependentParameterNames), difference(dependentParameterNames, usedParameterNames)), new Set(RESERVED_PARAMETER_NAMES)).size !== 0) {
-            throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Dependent parameters are not consistent with used parameters:
 
                     Dependent parameters:
@@ -7034,7 +7109,7 @@
             else if (!definedParameterNames.has(parameterName) && usedParameterNames.has(parameterName)) {
                 // Houston, we have a problem
                 // Note: Checking part is also done in `validatePipeline`, but it’s good to doublecheck
-                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${parameterName}}\` is NOT defined
                         BUT used in task "${currentTask.title || currentTask.name}"
 
@@ -7062,6 +7137,7 @@
             tools,
             $executionReport,
             onProgress,
+            logLlmCall,
             pipelineIdentification,
             maxExecutionAttempts,
             maxParallelCount,
@@ -7102,9 +7178,32 @@
         for (const parameter of preparedPipeline.parameters.filter(({ isOutput }) => isOutput)) {
             if (parametersToPass[parameter.name] === undefined) {
                 // [4]
-                $warnings.push(new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                $warnings.push(new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                             Parameter \`{${parameter.name}}\` should be an output parameter, but it was not generated during pipeline execution
 
+                            Note: This is a warning which happened after the pipeline was executed, and \`{${parameter.name}}\` was not for some reason defined in output parameters
+
+                            All parameters:
+                            ${block(preparedPipeline.parameters
+                .map(({ name, isInput, isOutput, description }) => {
+                let line = `\`{${name}}\``;
+                if (isInput) {
+                    line += ' `[input parameter]`';
+                }
+                if (isOutput) {
+                    line += ' `[output parameter]`';
+                }
+                if (parametersToPass[name] === undefined) {
+                    line += ` <- Warning: Should be in the output but its not |`;
+                }
+                if (description) {
+                    line += ` ${description}`;
+                }
+                return line;
+            })
+                .map((line, index) => `${index + 1}) ${line}`)
+                .join('\n'))}
+
                             ${block(pipelineIdentification)}
                         `)));
                 continue;
@@ -7125,7 +7224,7 @@
      * @private internal utility of `createPipelineExecutor`
      */
     async function executePipeline(options) {
-        const { inputParameters, tools, onProgress, pipeline, setPreparedPipeline, pipelineIdentification, maxParallelCount, rootDirname, isVerbose, } = options;
+        const { inputParameters, tools, onProgress, logLlmCall, pipeline, setPreparedPipeline, pipelineIdentification, maxParallelCount, rootDirname, isVerbose, } = options;
         let { preparedPipeline } = options;
         if (preparedPipeline === undefined) {
             preparedPipeline = await preparePipeline(pipeline, tools, {
@@ -7187,7 +7286,7 @@
         for (const parameterName of Object.keys(inputParameters)) {
             const parameter = preparedPipeline.parameters.find(({ name }) => name === parameterName);
             if (parameter === undefined) {
-                warnings.push(new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                warnings.push(new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                             Extra parameter {${parameterName}} is being passed which is not part of the pipeline.
 
                             ${block(pipelineIdentification)}
@@ -7202,7 +7301,7 @@
                 // TODO: [🧠] This should be also non-critical error
                 return exportJson({
                     name: 'pipelineExecutorResult',
-                    message: spaceTrim.spaceTrim((block) => `
+                    message: spaceTrim$1.spaceTrim((block) => `
                         Unsuccessful PipelineExecutorResult (with extra parameter {${parameter.name}}) PipelineExecutorResult
 
                         ${block(pipelineIdentification)}
@@ -7211,7 +7310,7 @@
                     value: {
                         isSuccessful: false,
                         errors: [
-                            new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                            new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                     Parameter \`{${parameter.name}}\` is passed as input parameter but it is not input
 
                                     ${block(pipelineIdentification)}
@@ -7238,7 +7337,7 @@
             while (unresovedTasks.length > 0) {
                 if (loopLimit-- < 0) {
                     // Note: Really UnexpectedError not LimitReachedError - this should be catched during validatePipeline
-                    throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                    throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                             Loop limit reached during resolving parameters pipeline execution
 
                             ${block(pipelineIdentification)}
@@ -7248,7 +7347,7 @@
                 if (!currentTask && resolving.length === 0) {
                     throw new UnexpectedError(
                     // TODO: [🐎] DRY
-                    spaceTrim.spaceTrim((block) => `
+                    spaceTrim$1.spaceTrim((block) => `
                             Can not resolve some parameters:
 
                             ${block(pipelineIdentification)}
@@ -7288,7 +7387,7 @@
                         tools,
                         onProgress(newOngoingResult) {
                             if (isReturned) {
-                                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                                         Can not call \`onProgress\` after pipeline execution is finished
 
                                         ${block(pipelineIdentification)}
@@ -7303,8 +7402,9 @@
                                 onProgress(newOngoingResult);
                             }
                         },
+                        logLlmCall,
                         $executionReport: executionReport,
-                        pipelineIdentification: spaceTrim.spaceTrim((block) => `
+                        pipelineIdentification: spaceTrim$1.spaceTrim((block) => `
                             ${block(pipelineIdentification)}
                             Task name: ${currentTask.name}
                             Task title: ${currentTask.title}
@@ -7413,7 +7513,7 @@
             preparedPipeline = pipeline;
         }
         else if (isNotPreparedWarningSuppressed !== true) {
-            console.warn(spaceTrim.spaceTrim((block) => `
+            console.warn(spaceTrim$1.spaceTrim((block) => `
                     Pipeline is not prepared
 
                     ${block(pipelineIdentification)}
@@ -7426,7 +7526,7 @@
             // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
         }
         let runCount = 0;
-        const pipelineExecutorWithCallback = async (inputParameters, onProgress) => {
+        const pipelineExecutorWithCallback = async (inputParameters, onProgress, logLlmCall) => {
             runCount++;
             return /* not await */ executePipeline({
                 pipeline,
@@ -7437,7 +7537,8 @@
                 inputParameters,
                 tools,
                 onProgress,
-                pipelineIdentification: spaceTrim.spaceTrim((block) => `
+                logLlmCall,
+                pipelineIdentification: spaceTrim$1.spaceTrim((block) => `
                     ${block(pipelineIdentification)}
                     ${runCount === 1 ? '' : `Run #${runCount}`}
                 `),
@@ -7640,10 +7741,10 @@
             var _a, _b;
             const isMetadataAviailable = $llmToolsMetadataRegister
                 .list()
-                .find(({ packageName, className }) => metadata.packageName === packageName && metadata.className === className);
+                .some(({ packageName, className }) => metadata.packageName === packageName && metadata.className === className);
             const isInstalled = $llmToolsRegister
                 .list()
-                .find(({ packageName, className }) => metadata.packageName === packageName && metadata.className === className);
+                .some(({ packageName, className }) => metadata.packageName === packageName && metadata.className === className);
             const isFullyConfigured = ((_a = metadata.envVariables) === null || _a === void 0 ? void 0 : _a.every((envVariableName) => env[envVariableName] !== undefined)) || false;
             const isPartiallyConfigured = ((_b = metadata.envVariables) === null || _b === void 0 ? void 0 : _b.some((envVariableName) => env[envVariableName] !== undefined)) || false;
             // <- Note: [🗨]
@@ -7820,6 +7921,8 @@
     /**
      * Normalizes a given text to camelCase format.
      *
+     * Note: [🔂] This function is idempotent.
+     *
      * @param text The text to be normalized.
      * @param _isFirstLetterCapital Whether the first letter should be capitalized.
      * @returns The camelCase formatted string.
@@ -7946,6 +8049,9 @@
     }
 
     /**
+     * Normalizes a given text to PascalCase format.
+     *
+     * Note: [🔂] This function is idempotent.
      *
      * @param text @public exported from `@promptbook/utils`
      * @returns
@@ -8010,7 +8116,7 @@
         let trimmedText = text;
         // Remove leading and trailing spaces and newlines
         if (isTrimmed) {
-            trimmedText = spaceTrim.spaceTrim(trimmedText);
+            trimmedText = spaceTrim$1.spaceTrim(trimmedText);
         }
         let processedText = trimmedText;
         if (isIntroduceSentenceRemoved) {
@@ -8019,7 +8125,7 @@
                 // Remove the introduce sentence and quotes by replacing it with an empty string
                 processedText = processedText.replace(introduceSentenceRegex, '');
             }
-            processedText = spaceTrim.spaceTrim(processedText);
+            processedText = spaceTrim$1.spaceTrim(processedText);
         }
         if (processedText.length < 3) {
             return trimmedText;
@@ -8123,13 +8229,13 @@
      * @public exported from `@promptbook/markdown-utils`
      */
     function trimCodeBlock(value) {
-        value = spaceTrim.spaceTrim(value);
+        value = spaceTrim$1.spaceTrim(value);
         if (!/^```[a-z]*(.*)```$/is.test(value)) {
             return value;
         }
         value = value.replace(/^```[a-z]*/i, '');
         value = value.replace(/```$/i, '');
-        value = spaceTrim.spaceTrim(value);
+        value = spaceTrim$1.spaceTrim(value);
         return value;
     }
 
@@ -8142,9 +8248,9 @@
      * @public exported from `@promptbook/markdown-utils`
      */
     function trimEndOfCodeBlock(value) {
-        value = spaceTrim.spaceTrim(value);
+        value = spaceTrim$1.spaceTrim(value);
         value = value.replace(/```$/g, '');
-        value = spaceTrim.spaceTrim(value);
+        value = spaceTrim$1.spaceTrim(value);
         return value;
     }
 
@@ -9009,7 +9115,10 @@
         }), h(KeyVal, {
             label: 'Application mode:',
             value: info.isApplicationModeAllowed ? 'enabled' : 'disabled',
-        }), h(KeyVal, { label: 'Running executions:', value: String(info.runningExecutions) })), h(Section, { title: 'Pipelines in collection' }, h(List, { items: info.pipelines })), h(Section, { title: 'Paths' }, h(List, { items: info.paths })), h(Section, { title: 'Instructions' }, h('ol', { className: 'list-decimal ml-6 space-y-1' }, h('li', null, 'The client ', h('a', { href: 'https://www.npmjs.com/package/@promptbook/remote-client', className: 'text-blue-600 underline' }, 'https://www.npmjs.com/package/@promptbook/remote-client')), h('li', null, 'OpenAI compatible client ', h('span', { className: 'text-gray-500' }, '(Not working yet)')), h('li', null, 'REST API')), h('p', { className: 'mt-2' }, 'For more information look at: ', h('a', { href: 'https://github.com/webgptorg/promptbook', className: 'text-blue-600 underline' }, 'https://github.com/webgptorg/promptbook'))));
+        }), h(KeyVal, { label: 'Running executions:', value: String(info.runningExecutions) })), h(Section, { title: 'Pipelines in collection' }, h(List, { items: info.pipelines })), h(Section, { title: 'Paths' }, h(List, { items: info.paths })), h(Section, { title: 'Instructions' }, h('ol', { className: 'list-decimal ml-6 space-y-1' }, h('li', null, 'The client ', h('a', {
+            href: 'https://www.npmjs.com/package/@promptbook/remote-client',
+            className: 'text-blue-600 underline',
+        }, 'https://www.npmjs.com/package/@promptbook/remote-client')), h('li', null, 'OpenAI compatible client ', h('span', { className: 'text-gray-500' }, '(Not working yet)')), h('li', null, 'REST API')), h('p', { className: 'mt-2' }, 'For more information look at: ', h('a', { href: 'https://github.com/webgptorg/promptbook', className: 'text-blue-600 underline' }, 'https://github.com/webgptorg/promptbook'))));
     }
     function HtmlDoc({ info }) {
         return h('html', { lang: 'en' }, h('head', null, h('meta', { charSet: 'UTF-8' }), h('meta', { name: 'viewport', content: 'width=device-width, initial-scale=1.0' }), h('title', null, 'Promptbook Server'), h('link', {
@@ -9026,6 +9135,7 @@
         return '<!DOCTYPE html>' + server.renderToStaticMarkup(h(HtmlDoc, { info }));
     }
 
+    // TODO: !!! Deprecate
     /**
      * Remote server is a proxy server that uses its execution tools internally and exposes the executor interface externally.
      *
@@ -9204,7 +9314,7 @@
                 response.type('text/html').send(renderServerIndexHtml(serverInfo));
             }
             else {
-                response.type('text/markdown').send(await spaceTrim.spaceTrim(async (block) => `
+                response.type('text/markdown').send(await spaceTrim$1.spaceTrim(async (block) => `
                         # Promptbook
 
                         > ${block(CLAIM)}
@@ -9332,10 +9442,10 @@
                     .send({ error: serializeError(error) });
             }
         });
-        function exportExecutionTask(executionTask, isFull) {
+        function exportExecutionTask(executionTask, isDetailed) {
             // <- TODO: [🧠] This should be maybe method of `ExecutionTask` itself
-            const { taskType, promptbookVersion, taskId, title, status, errors, tldr, warnings, createdAt, updatedAt, currentValue, } = executionTask;
-            if (isFull) {
+            const { taskType, promptbookVersion, taskId, title, status, errors, tldr, warnings, createdAt, updatedAt, currentValue, llmCalls, } = executionTask;
+            if (isDetailed) {
                 return {
                     taskId,
                     title,
@@ -9345,9 +9455,11 @@
                     tldr,
                     errors: errors.map(serializeError),
                     warnings: warnings.map(serializeError),
+                    llmCalls,
                     createdAt,
                     updatedAt,
                     currentValue,
+                    ptbkNonce: 0,
                 };
             }
             else {
@@ -9360,6 +9472,8 @@
                     tldr,
                     createdAt,
                     updatedAt,
+                    llmCalls,
+                    ptbkNonce: 0,
                 };
             }
         }
@@ -9587,21 +9701,25 @@
         };
     }
     /**
+
+     * TODO: [🕋] Use here `aboutPromptbookInformation`
      * TODO: [🌡] Add CORS and security - probably via `helmet`
      * TODO: Split this file into multiple functions - handler for each request
      * TODO: Maybe use `$exportJson`
      * TODO: [🧠][🛍] Maybe not `isAnonymous: boolean` BUT `mode: 'ANONYMOUS'|'COLLECTION'`
-     * TODO: [⚖] Expose the collection to be able to connect to same collection via createCollectionFromUrl
+     * TODO: [⚖] Expose the collection to be able to connect to same collection via createPipelineCollectionFromUrl
      * TODO: Handle progress - support streaming
      * TODO: [🗯] Do not hang up immediately but wait until client closes OR timeout
      * TODO: [🗯] Timeout on chat to free up resources
      * TODO: [🃏] Pass here some security token to prevent malitious usage and/or DDoS
      * TODO: [0] Set unavailable models as undefined in `RemoteLlmExecutionTools` NOT throw error here
      * TODO: Allow to constrain anonymous mode for specific models / providers
+     * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
      */
 
     exports.BOOK_LANGUAGE_VERSION = BOOK_LANGUAGE_VERSION;
     exports.PROMPTBOOK_ENGINE_VERSION = PROMPTBOOK_ENGINE_VERSION;
+    exports.startAgentServer = startAgentServer;
     exports.startRemoteServer = startRemoteServer;
 
     Object.defineProperty(exports, '__esModule', { value: true });