@promptbook/core 0.62.1 → 0.63.0-0

package/umd/index.umd.js

@@ -1,15 +1,25 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('prettier'), require('prettier/parser-html'), require('moment')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'prettier', 'prettier/parser-html', 'moment'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.spaceTrim, global.prettier, global.parserHtml, global.moment));
-})(this, (function (exports, spaceTrim, prettier, parserHtml, moment) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('prettier'), require('prettier/parser-html'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('moment')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'prettier', 'prettier/parser-html', 'crypto-js/enc-hex', 'crypto-js/sha256', 'moment'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.spaceTrim, global.prettier, global.parserHtml, global.hexEncoder, global.sha256, global.moment));
+})(this, (function (exports, spaceTrim, prettier, parserHtml, hexEncoder, sha256, moment) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
     var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
     var parserHtml__default = /*#__PURE__*/_interopDefaultLegacy(parserHtml);
+    var hexEncoder__default = /*#__PURE__*/_interopDefaultLegacy(hexEncoder);
+    var sha256__default = /*#__PURE__*/_interopDefaultLegacy(sha256);
     var moment__default = /*#__PURE__*/_interopDefaultLegacy(moment);
 
+    /**
+     * The version of the Promptbook library
+     *
+     * @public exported from all packages
+     */
+    var PROMPTBOOK_VERSION = '0.62.0';
+    // TODO: !!!! List here all the versions and annotate + put into script
+
     /*! *****************************************************************************
     Copyright (c) Microsoft Corporation.
 
@@ -133,6 +143,8 @@
      * Converts PipelineCollection to serialized JSON
      *
      * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
+     *
+     * @public exported from `@promptbook/core`
      */
     function collectionToJson(collection) {
         return __awaiter(this, void 0, void 0, function () {
@@ -191,6 +203,7 @@
     /**
      * Makes first letter of a string uppercase
      *
+     * @public exported from `@promptbook/utils`
      */
     function capitalize(word) {
         return word.substring(0, 1).toUpperCase() + word.substring(1);
@@ -201,6 +214,7 @@
      *
      * @param pipelineJson Promptbook in JSON format (.ptbk.json)
      * @returns Promptbook in string format (.ptbk.md)
+     * @public exported from `@promptbook/core`
      */
     function pipelineJsonToString(pipelineJson) {
         var e_1, _a, e_2, _b, e_3, _c, e_4, _d, e_5, _e, e_6, _f;
@@ -431,6 +445,7 @@
      * @@@
      *
      * @returns The same object as the input, but deeply frozen
+     * @public exported from `@promptbook/utils`
      *
      * Note: This function mutates the object and returns the original (but mutated-deep-freezed) object
      */
@@ -438,7 +453,6 @@
         return deepFreeze(objectValue);
     }
     /**
-     * TODO: [🔼] Export from `@promptbook/utils`
      * TODO: [🧠] Is there a way how to meaningfully test this utility
      */
 
@@ -464,22 +478,62 @@
 
     /**
      * The maximum number of iterations for a loops
+     *
+     * @private within the repository - too low-level in comparison to other `MAX_...`
      */
     var LOOP_LIMIT = 1000;
     /**
      * The maximum number of (LLM) tasks running in parallel
+     *
+     * @public exported from `@promptbook/core`
      */
     var MAX_PARALLEL_COUNT = 5;
     /**
      * The maximum number of attempts to execute LLM task before giving up
+     *
+     * @public exported from `@promptbook/core`
      */
     var MAX_EXECUTION_ATTEMPTS = 3;
+    /**
+     * The maximum length of the (generated) filename
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var MAX_FILENAME_LENGTH = 30;
+    /**
+     * @@@
+     * TODO: [🐝] !!! Use
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH = 3;
+    /**
+     * @@@
+     * TODO: [🐝] !!! Use
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL = 200;
+    /**
+     * Where to store the cache of executions for promptbook CLI
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var EXECUTIONS_CACHE_DIRNAME = '/.promptbook/executions-cache';
+    /**
+     * The name of the builded pipeline collection made by CLI `ptbk make` and for lookup in `createCollectionFromDirectory`
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var PIPELINE_COLLECTION_BASE_FILENAME = "index";
     /**
      * Nonce which is used for replacing things in strings
      */
     var REPLACING_NONCE = 'u$k42k%!V2zo34w7Fu#@QUHYPW';
     /**
      * The names of the parameters that are reserved for special purposes
+     *
+     * @public exported from `@promptbook/core`
      */
     var RESERVED_PARAMETER_NAMES = deepFreeze([
         'content',
@@ -493,10 +547,14 @@
     ]);
     /**
      * @@@
+     *
+     * @private within the repository
      */
     var RESERVED_PARAMETER_MISSING_VALUE = 'MISSING-' + REPLACING_NONCE;
     /**
      * @@@
+     *
+     * @private within the repository
      */
     var RESERVED_PARAMETER_RESTRICTED = 'RESTRICTED-' + REPLACING_NONCE;
     /*
@@ -504,11 +562,13 @@
     */
     // [🟡][🟢][🔵][⚪]
     /**
-     * TODO: [🔼] Export all to core
+     * TODO: !!!!!! Check that all @private contains some normalized explanation
      */
 
     /**
      * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
+     *
+     * @public exported from `@promptbook/core`
      */
     var ParsingError = /** @class */ (function (_super) {
         __extends(ParsingError, _super);
@@ -523,6 +583,8 @@
 
     /**
      * This error indicates that the promptbook object has valid syntax but contains logical errors (like circular dependencies)
+     *
+     * @public exported from `@promptbook/core`
      */
     var PipelineLogicError = /** @class */ (function (_super) {
         __extends(PipelineLogicError, _super);
@@ -537,6 +599,8 @@
 
     /**
      * This error type indicates that the error should not happen and its last check before crashing with some other error
+     *
+     * @public exported from `@promptbook/core`
      */
     var UnexpectedError = /** @class */ (function (_super) {
         __extends(UnexpectedError, _super);
@@ -555,6 +619,8 @@
      * Note: There are two simmilar functions:
      * - `isValidSemanticVersion` which tests any semantic version
      * - `isValidPromptbookVersion` *(this one)* which tests just Promptbook versions
+     *
+     * @public exported from `@promptbook/utils`
      */
     function isValidSemanticVersion(version) {
         if (typeof version !== 'string') {
@@ -575,6 +641,8 @@
      * Note: There are two simmilar functions:
      * - `isValidSemanticVersion` which tests any semantic version
      * - `isValidPromptbookVersion` *(this one)* which tests just Promptbook versions
+     *
+     * @public exported from `@promptbook/utils`
      */
     function isValidPromptbookVersion(version) {
         if (!isValidSemanticVersion(version)) {
@@ -593,6 +661,8 @@
      * Note: There are two simmilar functions:
      * - `isUrlOnPrivateNetwork` which tests full URL
      * - `isHostnameOnPrivateNetwork` *(this one)* which tests just hostname
+     *
+     * @public exported from `@promptbook/utils`
      */
     function isHostnameOnPrivateNetwork(hostname) {
         if (hostname === 'example.com' ||
@@ -627,6 +697,7 @@
      *
      * @param {string} ipAddress - The IP address to check.
      * @returns {boolean} Returns true if the IP address is reserved for private networks or localhost, otherwise false.
+     * @public exported from `@promptbook/utils`
      */
     function isUrlOnPrivateNetwork(url) {
         if (typeof url === 'string') {
@@ -642,6 +713,8 @@
      * Note: There are two simmilar functions:
      * - `isValidUrl` which tests any URL
      * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
+     *
+     * @public exported from `@promptbook/utils`
      */
     function isValidUrl(url) {
         if (typeof url !== 'string') {
@@ -668,6 +741,8 @@
      * Note: There are two simmilar functions:
      * - `isValidUrl` which tests any URL
      * - `isValidPipelineUrl` *(this one)* which tests just pipeline URL
+     *
+     * @public exported from `@promptbook/utils`
      */
     function isValidPipelineUrl(url) {
         if (!isValidUrl(url)) {
@@ -705,6 +780,7 @@
      * @param pipeline valid or invalid PipelineJson
      * @returns the same pipeline if it is logically valid
      * @throws {PipelineLogicError} on logical error in the pipeline
+     * @public exported from `@promptbook/core`
      */
     function validatePipeline(pipeline) {
         // TODO: [🧠] Maybe test if promptbook is a promise and make specific error case for that
@@ -934,6 +1010,8 @@
 
     /**
      * This error indicates that promptbook not found in the collection
+     *
+     * @public exported from `@promptbook/core`
      */
     var NotFoundError = /** @class */ (function (_super) {
         __extends(NotFoundError, _super);
@@ -948,6 +1026,8 @@
 
     /**
      * This error indicates errors in referencing promptbooks between each other
+     *
+     * @public exported from `@promptbook/core`
      */
     var ReferenceError$1 = /** @class */ (function (_super) {
         __extends(ReferenceError, _super);
@@ -965,6 +1045,7 @@
      *
      * @param template the template with parameters in {curly} braces
      * @returns the list of parameter names
+     * @public exported from `@promptbook/utils`
      */
     function extractParameterNames(template) {
         var e_1, _a;
@@ -989,6 +1070,8 @@
 
     /**
      * Unprepare just strips the preparation data of the pipeline
+     *
+     * @public exported from `@promptbook/core`
      */
     function unpreparePipeline(pipeline) {
         var personas = pipeline.personas, knowledgeSources = pipeline.knowledgeSources, promptTemplates = pipeline.promptTemplates;
@@ -1005,7 +1088,6 @@
         return __assign(__assign({}, pipeline), { promptTemplates: promptTemplates, knowledgeSources: knowledgeSources, knowledgePieces: [], personas: personas, preparations: [] });
     }
     /**
-     * TODO: [🔼] !!! Export via `@promptbook/core`
      * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
      * TODO: Write tests for `preparePipeline`
      * TODO: [🍙] Make some standart order of json properties
@@ -1107,6 +1189,7 @@
      *
      * @param promptbookSources
      * @returns PipelineCollection
+     * @public exported from `@promptbook/core`
      */
     function createCollectionFromJson() {
         var promptbooks = [];
@@ -1134,6 +1217,7 @@
      * @param promptbookSourcesPromiseOrFactory
      * @returns PipelineCollection
      * @deprecated Do not use, it will became internal tool for other constructor functions
+     * @public exported from `@promptbook/core`
      */
     function createCollectionFromPromise(promptbookSourcesPromiseOrFactory) {
         var collection = null;
@@ -1204,8 +1288,8 @@
 
     /**
      * Constructs Promptbook from remote Promptbase URL
-
      * @returns PipelineCollection
+     * @public exported from `@promptbook/core`
      */
     function createCollectionFromUrl(url, options) {
         return __awaiter(this, void 0, void 0, function () {
@@ -1245,6 +1329,7 @@
      *
      * @param promptbookSources
      * @returns PipelineCollection
+     * @public exported from `@promptbook/core`
      */
     function createSubcollection(collection, predicate) {
         function listPipelines() {
@@ -1320,6 +1405,7 @@
      * Block type describes the way how the block is blockd
      *
      * @see https://github.com/webgptorg/promptbook#block-type
+     * @public exported from `@promptbook/core`
      */
     var BlockTypes = [
         'PROMPT_TEMPLATE',
@@ -1335,6 +1421,8 @@
 
     /**
      * @@@
+     *
+     * @public exported from `@promptbook/utils`
      */
     function deepClone(objectValue) {
         return JSON.parse(JSON.stringify(objectValue));
@@ -1351,14 +1439,13 @@
         */
     }
     /**
-     * TODO: [🔼] Export from `@promptbook/utils`
      * TODO: [🧠] Is there a way how to meaningfully test this utility
      */
 
     /**
      * @@@
      *
-     * TODO: [🔼] Export with addUsage
+     * @public exported from `@promptbook/core`
      */
     var ZERO_USAGE = deepFreeze({
         price: { value: 0 },
@@ -1385,6 +1472,8 @@
      * Function `addUsage` will add multiple usages into one
      *
      * Note: If you provide 0 values, it returns ZERO_USAGE
+     *
+     * @public exported from `@promptbook/core`
      */
     function addUsage() {
         var usageItems = [];
@@ -1457,6 +1546,7 @@
      * @param array - Array to iterate over
      * @param options - Options for the function
      * @param callbackfunction - Function to call for each item
+     * @public exported from `@promptbook/utils`
      */
     function forEachAsync(array, options, callbackfunction) {
         return __awaiter(this, void 0, void 0, function () {
@@ -1743,6 +1833,8 @@
      * > "ě" => "e"
      * > "Ă" => "A"
      * > ...
+     *
+     * @public exported from `@promptbook/utils`
      */
     var DIACRITIC_VARIANTS_LETTERS = {};
     // tslint:disable-next-line: prefer-for-of
@@ -1770,7 +1862,11 @@
     */
 
     /**
+     * @@@
      *
+     * @param input @@@
+     * @returns @@@
+     * @public exported from `@promptbook/utils`
      */
     function removeDiacritics(input) {
         /*eslint no-control-regex: "off"*/
@@ -1778,7 +1874,19 @@
             return DIACRITIC_VARIANTS_LETTERS[a] || a;
         });
     }
+    /**
+     * TODO: [Ж] Variant for cyrillic (and in general non-latin) letters
+     */
 
+    /**
+     * @@@
+     *
+     * @param text @@@
+     * @returns @@@
+     * @example 'hello-world'
+     * @example 'i-love-promptbook'
+     * @public exported from `@promptbook/utils`
+     */
     function normalizeToKebabCase(text) {
         var e_1, _a;
         text = removeDiacritics(text);
@@ -1838,6 +1946,7 @@
      *
      * @param text with emojis
      * @returns text without emojis
+     * @public exported from `@promptbook/utils`
      */
     function removeEmojis(text) {
         // Replace emojis (and also ZWJ sequence) with hyphens
@@ -1849,7 +1958,12 @@
     }
 
     /**
-     * Function normalizes title to name which can be used as identifier
+     * @@@
+     *
+     * @param value @@@
+     * @returns @@@
+     * @example @@@
+     * @public exported from `@promptbook/utils`
      */
     function titleToName(value) {
         if (value.startsWith('http://') || value.startsWith('https://')) {
@@ -1868,6 +1982,8 @@
 
     /**
      * This error indicates errors during the execution of the pipeline
+     *
+     * @public exported from `@promptbook/core`
      */
     var PipelineExecutionError = /** @class */ (function (_super) {
         __extends(PipelineExecutionError, _super);
@@ -1885,6 +2001,7 @@
      *
      * @param executionResult - The partial result of the promptnook execution
      * @throws {PipelineExecutionError} If the execution is not successful or if multiple errors occurred
+     * @public exported from `@promptbook/core`
      */
     function assertsExecutionSuccessful(executionResult) {
         var isSuccessful = executionResult.isSuccessful, errors = executionResult.errors;
@@ -1915,6 +2032,7 @@
      * @param script from which to extract the variables
      * @returns the list of variable names
      * @throws {ParsingError} if the script is invalid
+     * @public exported from `@promptbook/utils`
      */
     function extractVariables(script) {
         var variables = new Set();
@@ -1963,6 +2081,7 @@
      * @param promptTemplate the template with used parameters
      * @returns the set of parameter names
      * @throws {ParsingError} if the script is invalid
+     * @public exported from `@promptbook/utils`
      */
     function extractParameterNamesFromPromptTemplate(promptTemplate) {
         var e_1, _a, e_2, _b, e_3, _c;
@@ -2036,6 +2155,8 @@
 
     /**
      * Function isValidJsonString will tell you if the string is valid JSON or not
+     *
+     * @public exported from `@promptbook/utils`
      */
     function isValidJsonString(value /* <- [👨‍⚖️] */) {
         try {
@@ -2262,6 +2383,8 @@
      *
      *
      * Tip: You don't have to use this function directly, just pass an array of LlmExecutionTools to the `ExecutionTools`
+     *
+     * @public exported from `@promptbook/core`
      */
     function joinLlmExecutionTools() {
         var llmExecutionTools = [];
@@ -2301,6 +2424,8 @@
 
     /**
      * Determine if the pipeline is fully prepared
+     *
+     * @public exported from `@promptbook/core`
      */
     function isPipelinePrepared(pipeline) {
         // Note: Ignoring `pipeline.preparations` @@@
@@ -2321,7 +2446,6 @@
     }
     /**
      * TODO: [🐠] Maybe base this on `makeValidator`
-     * TODO: [🔼] Export via core or utils
      * TODO: [🧊] Pipeline can be partially prepared, this should return true ONLY if fully prepared
      * TODO: [🧿] Maybe do same process with same granularity and subfinctions as `preparePipeline`
      *     - [🏍] ? Is context in each template
@@ -2367,6 +2491,8 @@
 
     /**
      * This error type indicates that some limit was reached
+     *
+     * @public exported from `@promptbook/core`
      */
     var LimitReachedError = /** @class */ (function (_super) {
         __extends(LimitReachedError, _super);
@@ -2386,6 +2512,7 @@
      * @param parameters the object with parameters
      * @returns the template with replaced parameters
      * @throws {PipelineExecutionError} if parameter is not defined, not closed, or not opened
+     * @public exported from `@promptbook/utils`
      */
     function replaceParameters(template, parameters) {
         var e_1, _a;
@@ -2461,6 +2588,7 @@
      * Create difference set of two sets.
      *
      * @deprecated use new javascript set methods instead @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
+     * @public exported from `@promptbook/utils`
      */
     function difference(a, b, isEqual) {
         var e_1, _a;
@@ -2494,6 +2622,7 @@
      * Creates a new set with all elements that are present in either set
      *
      * @deprecated use new javascript set methods instead @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
+     * @public exported from `@promptbook/utils`
      */
     function union() {
         var e_1, _a, e_2, _b;
@@ -2530,14 +2659,10 @@
         return union;
     }
 
-    /**
-     * The version of the Promptbook library
-     */
-    var PROMPTBOOK_VERSION = '0.62.0';
-    // TODO: !!!! List here all the versions and annotate + put into script
-
     /**
      * Counts number of characters in the text
+     *
+     * @public exported from `@promptbook/utils`
      */
     function countCharacters(text) {
         // Remove null characters
@@ -2551,6 +2676,8 @@
 
     /**
      * Counts number of lines in the text
+     *
+     * @public exported from `@promptbook/utils`
      */
     function countLines(text) {
         if (text === '') {
@@ -2561,6 +2688,8 @@
 
     /**
      * Counts number of pages in the text
+     *
+     * @public exported from `@promptbook/utils`
      */
     function countPages(text) {
         var sentencesPerPage = 5; // Assuming each page has 5 sentences
@@ -2571,6 +2700,8 @@
 
     /**
      * Counts number of paragraphs in the text
+     *
+     * @public exported from `@promptbook/utils`
      */
     function countParagraphs(text) {
         return text.split(/\n\s*\n/).filter(function (paragraph) { return paragraph.trim() !== ''; }).length;
@@ -2578,12 +2709,16 @@
 
     /**
      * Split text into sentences
+     *
+     * @public exported from `@promptbook/utils`
      */
     function splitIntoSentences(text) {
         return text.split(/[.!?]+/).filter(function (sentence) { return sentence.trim() !== ''; });
     }
     /**
      * Counts number of sentences in the text
+     *
+     * @public exported from `@promptbook/utils`
      */
     function countSentences(text) {
         return splitIntoSentences(text).length;
@@ -2591,6 +2726,8 @@
 
     /**
      * Counts number of words in the text
+     *
+     * @public exported from `@promptbook/utils`
      */
     function countWords(text) {
         text = text.replace(/[\p{Extended_Pictographic}]/gu, 'a');
@@ -2600,6 +2737,8 @@
 
     /**
      * Index of all counter functions
+     *
+     * @public exported from `@promptbook/utils`
      */
     var CountUtils = {
         CHARACTERS: countCharacters,
@@ -2619,6 +2758,7 @@
      *
      * @throws {ExpectError} if the expectations are not met
      * @returns {void} Nothing
+     * @public exported from `@promptbook/core`
      */
     function checkExpectations(expectations, value) {
         var e_1, _a;
@@ -2650,6 +2790,7 @@
      * - `isPassingExpectations` which returns a boolean
      *
      * @returns {boolean} True if the expectations are met
+     * @public exported from `@promptbook/core`
      */
     function isPassingExpectations(expectations, value) {
         try {
@@ -2672,6 +2813,7 @@
      *
      * @returns The executor function
      * @throws {PipelineLogicError} on logical error in the pipeline
+     * @public exported from `@promptbook/core`
      */
     function createPipelineExecutor(options) {
         var _this = this;
@@ -3460,6 +3602,8 @@
 
     /**
      * @@@
+     *
+     * @public exported from `@promptbook/core`
      */
     function prepareKnowledgeFromMarkdown(knowledgeContent /* <- TODO: [🖖] (?maybe not) Always the file */, options) {
         return __awaiter(this, void 0, void 0, function () {
@@ -3595,6 +3739,7 @@
      * Prepares the knowle
      *
      * @see https://github.com/webgptorg/promptbook/discussions/41
+     * @public exported from `@promptbook/core`
      */
     function prepareKnowledgePieces(knowledgeSources, options) {
         return __awaiter(this, void 0, void 0, function () {
@@ -3609,7 +3754,7 @@
                                 var partialPieces, pieces;
                                 return __generator(this, function (_a) {
                                     switch (_a.label) {
-                                        case 0: return [4 /*yield*/, prepareKnowledgeFromMarkdown(knowledgeSource.source, // <- TODO: [🐝] !!! Unhardcode markdown, detect which type it is
+                                        case 0: return [4 /*yield*/, prepareKnowledgeFromMarkdown(knowledgeSource.source, // <- TODO: [🐝] !!! Unhardcode markdown, detect which type it is - BE AWARE of big package size
                                             options)];
                                         case 1:
                                             partialPieces = _a.sent();
@@ -3647,7 +3792,6 @@
     > ):
     */
     /**
-     * TODO: [🐝][🔼] !!! Export via `@promptbook/core`
      * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
      *       Put `knowledgePieces` into `PrepareKnowledgeOptions`
      * TODO: [🪂] More than max things can run in parallel by acident [1,[2a,2b,_],[3a,3b,_]]
@@ -3661,6 +3805,7 @@
      *
      * @param llmTools LLM tools to be intercepted with usage counting
      * @returns LLM tools with same functionality with added total cost counting
+     * @public exported from `@promptbook/core`
      */
     function countTotalUsage(llmTools) {
         var _this = this;
@@ -3728,7 +3873,6 @@
         return proxyTools;
     }
     /**
-     * TODO: [🔼] !!! Export via `@promptbookcore/`
      * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
      * TODO: [🧠] Is there some meaningfull way how to test this util
      * TODO: [🧠][🌯] Maybe a way how to hide ability to `get totalUsage`
@@ -3740,6 +3884,7 @@
      * Prepares the persona for the pipeline
      *
      * @see https://github.com/webgptorg/promptbook/discussions/22
+     * @public exported from `@promptbook/core`
      */
     function preparePersona(personaDescription, options) {
         return __awaiter(this, void 0, void 0, function () {
@@ -3794,7 +3939,6 @@
         });
     }
     /**
-     * TODO: [🔼] !!! Export via `@promptbook/core`
      * TODO: [🏢] !! Check validity of `modelName` in pipeline
      * TODO: [🏢] !! Check validity of `systemMessage` in pipeline
      * TODO: [🏢] !! Check validity of `temperature` in pipeline
@@ -3802,6 +3946,8 @@
 
     /**
      * @@@
+     *
+     * @public exported from `@promptbook/core`
      */
     function prepareTemplates(pipeline, options) {
         return __awaiter(this, void 0, void 0, function () {
@@ -3843,7 +3989,6 @@
      * TODO: [🧠] Add context to each template (if missing)
      * TODO: [🧠] What is better name `prepareTemplate` or `prepareTemplateAndParameters`
      * TODO: [♨] !!! Prepare index the samples and maybe templates
-     * TODO: [🔼] !!! Export via `@promptbook/core`
      * TODO: Write tests for `preparePipeline`
      * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
      * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
@@ -3856,6 +4001,7 @@
      *
      * Note: This function does not validate logic of the pipeline
      * Note: This function acts as part of compilation process
+     * @public exported from `@promptbook/core`
      */
     function preparePipeline(pipeline, options) {
         return __awaiter(this, void 0, void 0, function () {
@@ -3932,7 +4078,6 @@
         });
     }
     /**
-     * TODO: [🔼] !!! Export via `@promptbook/core`
      * TODO: Write tests for `preparePipeline`
      * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
      * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
@@ -3943,6 +4088,7 @@
      * Tests if given string is valid URL.
      *
      * Note: This does not check if the file exists only if the path is valid
+     * @public exported from `@promptbook/utils`
      */
     function isValidFilePath(filePath) {
         if (typeof filePath !== 'string') {
@@ -4125,6 +4271,7 @@
      *
      * @param {string} str - The string to remove Markdown tags from.
      * @returns {string} The input string with all Markdown tags removed.
+     * @public exported from `@promptbook/markdown-utils`
      */
     function removeMarkdownFormatting(str) {
         // Remove bold formatting
@@ -4136,6 +4283,15 @@
         return str;
     }
 
+    /**
+     * @@@
+     *
+     * @param text @@@
+     * @returns @@@
+     * @example 'HELLO_WORLD'
+     * @example 'I_LOVE_PROMPTBOOK'
+     * @public exported from `@promptbook/utils`
+     */
     function normalizeTo_SCREAMING_CASE(text) {
         var e_1, _a;
         var charType;
@@ -4303,7 +4459,7 @@
      * @returns parsed number
      * @throws {ParsingError} if the value is not a number
      *
-     * @private within the parseCommand
+     * @public exported from `@promptbook/utils`
      */
     function parseNumber(value) {
         var originalValue = value;
@@ -4359,6 +4515,7 @@
     }
     /**
      * TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
+     * TODO: [🧠][🌻] Maybe export through `@promptbook/markdown-utils` not `@promptbook/utils`
      */
 
     /**
@@ -4670,6 +4827,13 @@
         },
     };
 
+    /**
+     * @@@
+     *
+     * @param javascriptName @@@
+     * @returns @@@
+     * @public exported from `@promptbook/utils`
+     */
     function isValidJavascriptName(javascriptName) {
         if (typeof javascriptName !== 'string') {
             return false;
@@ -5142,6 +5306,8 @@
 
     /**
      * This error type indicates that some part of the code is not implemented yet
+     *
+     * @public exported from `@promptbook/core`
      */
     var NotYetImplementedError = /** @class */ (function (_super) {
         __extends(NotYetImplementedError, _super);
@@ -5168,7 +5334,8 @@
      * Note: It can not work with html syntax and comments
      *
      * @param markdown any valid markdown
-     * @returns
+     * @returns @@@
+     * @public exported from `@promptbook/markdown-utils`
      */
     function extractAllListItemsFromMarkdown(markdown) {
         var e_1, _a;
@@ -5208,7 +5375,7 @@
      *
      * @param markdown any valid markdown
      * @returns code blocks with language and content
-     *
+     * @public exported from `@promptbook/markdown-utils`
      */
     function extractAllBlocksFromMarkdown(markdown) {
         var e_1, _a;
@@ -5285,6 +5452,7 @@
      *
      * @param markdown any valid markdown
      * @returns code block with language and content
+     * @public exported from `@promptbook/markdown-utils`
      */
     function extractOneBlockFromMarkdown(markdown) {
         var codeBlocks = extractAllBlocksFromMarkdown(markdown);
@@ -5299,6 +5467,8 @@
 
     /**
      * Parses markdown section to title its level and content
+     *
+     * @public exported from `@promptbook/markdown-utils`
      */
     function parseMarkdownSection(value) {
         var _a, _b;
@@ -5323,6 +5493,8 @@
 
     /**
      * Splits the markdown into sections by headings
+     *
+     * @public exported from `@promptbook/markdown-utils`
      */
     function splitMarkdownIntoSections(markdown) {
         var e_1, _a;
@@ -5384,6 +5556,7 @@
         return sections;
     }
     /**
+     * TODO: [🏛] This can be part of markdown builder
      * Note: [🕞] In past (commit 42086e1603cbed506482997c00a8ee979af0a247) there was much more
      *       sophisticated implementation of this function through parsing markdown into JSON structure
      *       and flattening the actual structure
@@ -5395,6 +5568,8 @@
      *
      * - It always have h1 - if there is no h1 in the markdown, it will be added "# Untitled"
      * - All other headings are normalized to h2
+     *
+     * @public exported from `@promptbook/markdown-utils`
      */
     function flattenMarkdown(markdown) {
         var e_1, _a;
@@ -5430,6 +5605,7 @@
         return spaceTrim__default["default"](flattenedMarkdown);
     }
     /**
+     * TODO: [🏛] This can be part of markdown builder
      * Note: [🕞] In past (commit 42086e1603cbed506482997c00a8ee979af0a247) there was much more
      *       sophisticated implementation of this function through parsing markdown into JSON structure
      *       and flattening the actual structure
@@ -5441,6 +5617,7 @@
      *
      * @param {string} content - The string to remove comments from.
      * @returns {string} The input string with all comments removed.
+     * @public exported from `@promptbook/markdown-utils`
      */
     function removeContentComments(content) {
         return spaceTrim.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
@@ -5454,12 +5631,13 @@
      * - `pipelineStringToJsonSync` - use only if you need to compile promptbook synchronously and it contains NO external knowledge
      * - `preparePipeline` - just one step in the compilation process
      *
+     * Note: This function does not validate logic of the pipeline only the syntax
+     * Note: This function acts as compilation process
+     *
      * @param pipelineString {Promptbook} in string markdown format (.ptbk.md)
      * @returns {Promptbook} compiled in JSON format (.ptbk.json)
      * @throws {ParsingError} if the promptbook string is not valid
-     *
-     * Note: This function does not validate logic of the pipeline only the syntax
-     * Note: This function acts as compilation process
+     * @public exported from `@promptbook/core`
      */
     function pipelineStringToJsonSync(pipelineString) {
         var e_1, _a, e_2, _b;
@@ -5852,13 +6030,14 @@
      * - `pipelineStringToJsonSync` - use only if you need to compile promptbook synchronously and it contains NO external knowledge
      * - `preparePipeline` - just one step in the compilation process
      *
+     * Note: This function does not validate logic of the pipeline only the syntax
+     * Note: This function acts as compilation process
+     *
      * @param pipelineString {Promptbook} in string markdown format (.ptbk.md)
      * @param options - Options and tools for the compilation
      * @returns {Promptbook} compiled in JSON format (.ptbk.json)
      * @throws {ParsingError} if the promptbook string is not valid
-     *
-     * Note: This function does not validate logic of the pipeline only the syntax
-     * Note: This function acts as compilation process
+     * @public exported from `@promptbook/core`
      */
     function pipelineStringToJson(pipelineString, options) {
         if (options === void 0) { options = { llmTools: null }; }
@@ -5887,7 +6066,7 @@
     /**
      * Add or modify an auto-generated section in a markdown file
      *
-     * @private within the repository
+     * @public exported from `@promptbook/markdown-utils`
      */
     function addAutoGeneratedSection(content, options) {
         var sectionName = options.sectionName, sectionContent = options.sectionContent;
@@ -5907,7 +6086,20 @@
         var _a = __read(placeForSection, 1), heading = _a[0];
         return content.replace(heading, "<!--".concat(sectionName, "-->\n").concat(warningLine, "\n").concat(sectionContent, "\n<!--/").concat(sectionName, "-->\n\n").concat(heading));
     }
+    /**
+     * TODO: [🏛] This can be part of markdown builder
+     */
 
+    /**
+     * @@@
+     *
+     * @param text @@@
+     * @param _isFirstLetterCapital @@@
+     * @returns @@@
+     * @example 'helloWorld'
+     * @example 'iLovePromptbook'
+     * @public exported from `@promptbook/utils`
+     */
     function normalizeTo_camelCase(text, _isFirstLetterCapital) {
         var e_1, _a;
         if (_isFirstLetterCapital === void 0) { _isFirstLetterCapital = false; }
@@ -5966,6 +6158,8 @@
      * Creates a Mermaid graph based on the promptbook
      *
      * Note: The result is not wrapped in a Markdown code block
+     *
+     * @public exported from `@promptbook/utils`
      */
     function renderPromptbookMermaid(pipelineJson, options) {
         var _a = (options || {}).linkPromptTemplate, linkPromptTemplate = _a === void 0 ? function () { return null; } : _a;
@@ -6022,6 +6216,8 @@
 
     /**
      * Prettyfies Promptbook string and adds Mermaid graph
+     *
+     * @public exported from `@promptbook/core`
      */
     function prettifyPipelineString(pipelineString, options) {
         return __awaiter(this, void 0, void 0, function () {
@@ -6064,6 +6260,8 @@
      *
      * Note: [0] It can be used for more JSON types like whole collection of pipelines, single knowledge piece, etc.
      * Note: In contrast to JSON.stringify, this function ensures that **embedding index** is on single line
+     *
+     * @public exported from `@promptbook/core`
      */
     function stringifyPipelineJson(pipeline) {
         var pipelineJsonStringified = JSON.stringify(pipeline, null, 4);
@@ -6083,6 +6281,8 @@
 
     /**
      * This error indicates that the pipeline collection cannot be propperly loaded
+     *
+     * @public exported from `@promptbook/core`
      */
     var CollectionError = /** @class */ (function (_super) {
         __extends(CollectionError, _super);
@@ -6095,8 +6295,26 @@
         return CollectionError;
     }(Error));
 
+    /**
+     * This error type indicates that you try to use a feature that is not available in the current environment
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var EnvironmentMismatchError = /** @class */ (function (_super) {
+        __extends(EnvironmentMismatchError, _super);
+        function EnvironmentMismatchError(message) {
+            var _this = _super.call(this, message) || this;
+            _this.name = 'EnvironmentMismatchError';
+            Object.setPrototypeOf(_this, EnvironmentMismatchError.prototype);
+            return _this;
+        }
+        return EnvironmentMismatchError;
+    }(Error));
+
     /**
      * This error type indicates that the version of the pipeline is not matching the expected version
+     *
+     * @public exported from `@promptbook/core`
      */
     var VersionMismatchError = /** @class */ (function (_super) {
         __extends(VersionMismatchError, _super);
@@ -6111,6 +6329,8 @@
 
     /**
      * Pretty print an embedding vector for logging
+     *
+     * @public exported from `@promptbook/core`
      */
     function embeddingVectorToString(embeddingVector) {
         var vectorLength = Math.pow(embeddingVector.reduce(function (acc, val) { return acc + Math.pow(val, 2); }, 0), 0.5);
@@ -6123,6 +6343,8 @@
      * Note: This is an estimate based of theese sources:
      * - https://jecas.cz/doba-cteni
      * - https://www.originalnitonery.cz/blog/psani-vsemi-deseti-se-muzete-naucit-i-sami-doma
+     *
+     * @public exported from `@promptbook/core`
      */
     function usageToWorktime(usage) {
         var value = usage.input.wordsCount.value / (200 /* words per minute */ * 60) +
@@ -6137,6 +6359,8 @@
 
     /**
      * Function `usageToHuman` will take usage and convert it to human readable report
+     *
+     * @public exported from `@promptbook/core`
      */
     function usageToHuman(usage) {
         var report = 'Usage:';
@@ -6161,6 +6385,8 @@
     /**
      * Delagates the user interaction to a async callback function
      * You need to provide your own implementation of this callback function and its bind to UI.
+     *
+     * @public exported from `@promptbook/core`
      */
     var CallbackInterfaceTools = /** @class */ (function () {
         function CallbackInterfaceTools(options) {
@@ -6193,6 +6419,8 @@
      *
      * Warning: It is used for testing and mocking
      *          **NOT intended to use in the production** due to its synchronous nature.
+     *
+     * @public exported from `@promptbook/core`
      */
     var SimplePromptInterfaceTools = /** @class */ (function () {
         function SimplePromptInterfaceTools(options) {
@@ -6224,12 +6452,260 @@
      */
 
     /**
-     * Default options for generating an execution report string
+     * Stores
+     *
+     * @public exported from `@promptbook/core`
      */
-    var ExecutionReportStringOptionsDefaults = {
-        taxRate: 0,
-        chartsWidth: 36,
-    };
+    var MemoryStorage = /** @class */ (function () {
+        function MemoryStorage() {
+            this.storage = {};
+        }
+        Object.defineProperty(MemoryStorage.prototype, "length", {
+            /**
+             * Returns the number of key/value pairs currently present in the list associated with the object.
+             */
+            get: function () {
+                return Object.keys(this.storage).length;
+            },
+            enumerable: false,
+            configurable: true
+        });
+        /**
+         * Empties the list associated with the object of all key/value pairs, if there are any.
+         */
+        MemoryStorage.prototype.clear = function () {
+            this.storage = {};
+        };
+        /**
+         * Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.
+         */
+        MemoryStorage.prototype.getItem = function (key) {
+            return this.storage[key] || null;
+        };
+        /**
+         * Returns the name of the nth key in the list, or null if n is greater than or equal to the number of key/value pairs in the object.
+         */
+        MemoryStorage.prototype.key = function (index) {
+            return Object.keys(this.storage)[index] || null;
+        };
+        /**
+         * Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
+         */
+        MemoryStorage.prototype.setItem = function (key, value) {
+            this.storage[key] = value;
+        };
+        /**
+         * Removes the key/value pair with the given key from the list associated with the object, if a key/value pair with the given key exists.
+         */
+        MemoryStorage.prototype.removeItem = function (key) {
+            delete this.storage[key];
+        };
+        return MemoryStorage;
+    }());
+
+    /**
+     * Simple wrapper `new Date().toISOString()`
+     *
+     * @returns string_date branded type
+     * @public exported from `@promptbook/utils`
+     */
+    function $currentDate() {
+        return new Date().toISOString();
+    }
+
+    /**
+     * Intercepts LLM tools and counts total usage of the tools
+     *
+     * Note: It can take extended `LlmExecutionTools` and cache the
+     *
+     * @param llmTools LLM tools to be intercepted with usage counting, it can contain extra methods like `totalUsage`
+     * @returns LLM tools with same functionality with added total cost counting
+     * @public exported from `@promptbook/core`
+     */
+    function cacheLlmTools(llmTools, options) {
+        var _this = this;
+        if (options === void 0) { options = {}; }
+        var _a = options.storage, storage = _a === void 0 ? new MemoryStorage() : _a, _b = options.isReloaded, isReloaded = _b === void 0 ? false : _b;
+        var proxyTools = __assign(__assign({}, llmTools), { 
+            // <- Note: [🥫]
+            get title() {
+                // TODO: [🧠] Maybe put here some suffix
+                return llmTools.title;
+            },
+            get description() {
+                // TODO: [🧠] Maybe put here some suffix
+                return llmTools.description;
+            }, listModels: function () {
+                // TODO: [🧠] Should be model listing also cached?
+                return /* not await */ llmTools.listModels();
+            } });
+        var callCommonModel = function (prompt) { return __awaiter(_this, void 0, void 0, function () {
+            var key, cacheItem, _a, promptResult, _b;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        key = titleToName(prompt.title.substring(0, MAX_FILENAME_LENGTH - 10) +
+                            '-' +
+                            sha256__default["default"](hexEncoder__default["default"].parse(JSON.stringify(prompt.parameters))).toString( /* hex */));
+                        if (!!isReloaded) return [3 /*break*/, 2];
+                        return [4 /*yield*/, storage.getItem(key)];
+                    case 1:
+                        _a = _c.sent();
+                        return [3 /*break*/, 3];
+                    case 2:
+                        _a = null;
+                        _c.label = 3;
+                    case 3:
+                        cacheItem = _a;
+                        if (cacheItem) {
+                            return [2 /*return*/, cacheItem.promptResult];
+                        }
+                        _b = prompt.modelRequirements.modelVariant;
+                        switch (_b) {
+                            case 'CHAT': return [3 /*break*/, 4];
+                            case 'COMPLETION': return [3 /*break*/, 6];
+                            case 'EMBEDDING': return [3 /*break*/, 8];
+                        }
+                        return [3 /*break*/, 10];
+                    case 4: return [4 /*yield*/, llmTools.callChatModel(prompt)];
+                    case 5:
+                        promptResult = _c.sent();
+                        return [3 /*break*/, 11];
+                    case 6: return [4 /*yield*/, llmTools.callCompletionModel(prompt)];
+                    case 7:
+                        promptResult = _c.sent();
+                        return [3 /*break*/, 11];
+                    case 8: return [4 /*yield*/, llmTools.callEmbeddingModel(prompt)];
+                    case 9:
+                        promptResult = _c.sent();
+                        return [3 /*break*/, 11];
+                    case 10: throw new PipelineExecutionError("Unknown model variant \"".concat(prompt.modelRequirements.modelVariant, "\""));
+                    case 11: return [4 /*yield*/, storage.setItem(key, {
+                            date: $currentDate(),
+                            promptbookVersion: PROMPTBOOK_VERSION,
+                            prompt: prompt,
+                            promptResult: promptResult,
+                        })];
+                    case 12:
+                        _c.sent();
+                        return [2 /*return*/, promptResult];
+                }
+            });
+        }); };
+        if (llmTools.callChatModel !== undefined) {
+            proxyTools.callChatModel = function (prompt) { return __awaiter(_this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    return [2 /*return*/, /* not await */ callCommonModel(prompt)];
+                });
+            }); };
+        }
+        if (llmTools.callCompletionModel !== undefined) {
+            proxyTools.callCompletionModel = function (prompt) { return __awaiter(_this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    return [2 /*return*/, /* not await */ callCommonModel(prompt)];
+                });
+            }); };
+        }
+        if (llmTools.callEmbeddingModel !== undefined) {
+            proxyTools.callEmbeddingModel = function (prompt) { return __awaiter(_this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    return [2 /*return*/, /* not await */ callCommonModel(prompt)];
+                });
+            }); };
+        }
+        // <- Note: [🤖]
+        return proxyTools;
+    }
+    /**
+     * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
+     * TODO: [🧠] Is there some meaningfull way how to test this util
+     * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+     *            @@@ write discussion about this and storages
+     *            @@@ write how to combine multiple interceptors
+     */
+
+    /**
+     * @@@
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function limitTotalUsage(llmTools, options) {
+        var _this = this;
+        if (options === void 0) { options = {}; }
+        var _a = options.maxTotalUsage, maxTotalUsage = _a === void 0 ? ZERO_USAGE : _a, _b = options.storage, storage = _b === void 0 ? new MemoryStorage() : _b;
+        TODO_USE(storage);
+        var proxyTools = countTotalUsage(llmTools);
+        if (maxTotalUsage.price.value !== 0) {
+            throw new NotYetImplementedError('`limitTotalUsage` is not yet implemented for non-zero price');
+            // TODO: "Cannot call `callChatModel` because the total cost limit is reached"
+        }
+        if (proxyTools.callChatModel !== undefined) {
+            proxyTools.callChatModel = function (prompt) { return __awaiter(_this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    TODO_USE(prompt);
+                    throw new LimitReachedError('Cannot call `callChatModel` because you are not allowed to spend any cost');
+                });
+            }); };
+        }
+        if (proxyTools.callCompletionModel !== undefined) {
+            proxyTools.callCompletionModel = function (prompt) { return __awaiter(_this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    TODO_USE(prompt);
+                    throw new LimitReachedError('Cannot call `callCompletionModel` because you are not allowed to spend any cost');
+                });
+            }); };
+        }
+        if (proxyTools.callEmbeddingModel !== undefined) {
+            proxyTools.callEmbeddingModel = function (prompt) { return __awaiter(_this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    TODO_USE(prompt);
+                    throw new LimitReachedError('Cannot call `callEmbeddingModel` because you are not allowed to spend any cost');
+                });
+            }); };
+        }
+        // <- Note: [🤖]
+        return proxyTools;
+    }
+    /**
+     * TODO: Maybe internally use `countTotalUsage`
+     * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
+     * TODO: [🧠] Is there some meaningfull way how to test this util
+     * TODO: [🧠][🌯] Maybe a way how to hide ability to `get totalUsage`
+     * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+     */
+
+    /**
+     * This class behaves like LocalStorage but separates keys by prefix
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var PrefixStorage = /** @class */ (function () {
+        function PrefixStorage(baseStorage, keyPrefix, separator) {
+            if (separator === void 0) { separator = '_'; }
+            this.baseStorage = baseStorage;
+            this.keyPrefix = keyPrefix;
+            this.separator = separator;
+        }
+        /**
+         * Returns the current value associated with the given key, or null if the given key does not exist in the list associated with the object.
+         */
+        PrefixStorage.prototype.getItem = function (key) {
+            return this.baseStorage.getItem(this.keyPrefix + this.separator + key);
+        };
+        /**
+         * Sets the value of the pair identified by key to value, creating a new key/value pair if none existed for key previously.
+         */
+        PrefixStorage.prototype.setItem = function (key, value) {
+            return this.baseStorage.setItem(this.keyPrefix + this.separator + key, value);
+        };
+        /**
+         * Removes the key/value pair with the given key from the list associated with the object, if a key/value pair with the given key exists.
+         */
+        PrefixStorage.prototype.removeItem = function (key) {
+            this.baseStorage.removeItem(this.keyPrefix + this.separator + key);
+        };
+        return PrefixStorage;
+    }());
 
     /**
      * Format either small or big number
@@ -6254,7 +6730,7 @@
     /**
      * Create a markdown table from a 2D array of strings
      *
-     * @private within the repository
+     * @public exported from `@promptbook/markdown-utils`
      */
     function createMarkdownTable(table) {
         var columnWidths = table.reduce(function (widths, row) {
@@ -6278,11 +6754,14 @@
         });
         return __spreadArray([header, separator], __read(rows), false).join('\n');
     }
+    /**
+     * TODO: [🏛] This can be part of markdown builder
+     */
 
     /**
      * Function createMarkdownChart will draw a chart in markdown from ⬛+🟦 tiles
      *
-     * @private within the repository
+     * @public exported from `@promptbook/markdown-utils`
      */
     function createMarkdownChart(options) {
         var e_1, _a;
@@ -6318,10 +6797,25 @@
     /**
      * Function escapeMarkdownBlock will escape markdown block if needed
      * It is useful when you want have block in block
+     *
+     * @public exported from `@promptbook/markdown-utils`
      */
     function escapeMarkdownBlock(value) {
         return value.replace(/```/g, '\\`\\`\\`');
     }
+    /**
+     * TODO: [🏛] This can be part of markdown builder
+     */
+
+    /**
+     * Default options for generating an execution report string
+     *
+     * @public exported from `@promptbook/core`
+     */
+    var ExecutionReportStringOptionsDefaults = {
+        taxRate: 0,
+        chartsWidth: 36,
+    };
 
     /**
      * The thresholds for the relative time in the `moment` NPM package.
@@ -6367,6 +6861,8 @@
 
     /**
      * Converts execution report from JSON to string format
+     *
+     * @public exported from `@promptbook/core`
      */
     function executionReportJsonToString(executionReportJson, options) {
         var e_1, _a;
@@ -6539,22 +7035,36 @@
     exports.BlockTypes = BlockTypes;
     exports.CallbackInterfaceTools = CallbackInterfaceTools;
     exports.CollectionError = CollectionError;
+    exports.EXECUTIONS_CACHE_DIRNAME = EXECUTIONS_CACHE_DIRNAME;
+    exports.EnvironmentMismatchError = EnvironmentMismatchError;
     exports.ExecutionReportStringOptionsDefaults = ExecutionReportStringOptionsDefaults;
-    exports.ExpectError = ExpectError;
+    exports.LimitReachedError = LimitReachedError;
+    exports.MAX_EXECUTION_ATTEMPTS = MAX_EXECUTION_ATTEMPTS;
+    exports.MAX_FILENAME_LENGTH = MAX_FILENAME_LENGTH;
+    exports.MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH = MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH;
+    exports.MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL = MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL;
+    exports.MAX_PARALLEL_COUNT = MAX_PARALLEL_COUNT;
+    exports.MemoryStorage = MemoryStorage;
     exports.NotFoundError = NotFoundError;
+    exports.NotYetImplementedError = NotYetImplementedError;
+    exports.PIPELINE_COLLECTION_BASE_FILENAME = PIPELINE_COLLECTION_BASE_FILENAME;
     exports.PROMPTBOOK_VERSION = PROMPTBOOK_VERSION;
     exports.ParsingError = ParsingError;
     exports.PipelineExecutionError = PipelineExecutionError;
     exports.PipelineLogicError = PipelineLogicError;
+    exports.PrefixStorage = PrefixStorage;
     exports.RESERVED_PARAMETER_NAMES = RESERVED_PARAMETER_NAMES;
     exports.ReferenceError = ReferenceError$1;
     exports.SimplePromptInterfaceTools = SimplePromptInterfaceTools;
     exports.UnexpectedError = UnexpectedError;
     exports.VersionMismatchError = VersionMismatchError;
+    exports.ZERO_USAGE = ZERO_USAGE;
     exports.addUsage = addUsage;
     exports.assertsExecutionSuccessful = assertsExecutionSuccessful;
+    exports.cacheLlmTools = cacheLlmTools;
     exports.checkExpectations = checkExpectations;
     exports.collectionToJson = collectionToJson;
+    exports.countTotalUsage = countTotalUsage;
     exports.createCollectionFromJson = createCollectionFromJson;
     exports.createCollectionFromPromise = createCollectionFromPromise;
     exports.createCollectionFromUrl = createCollectionFromUrl;
@@ -6563,12 +7073,17 @@
     exports.embeddingVectorToString = embeddingVectorToString;
     exports.executionReportJsonToString = executionReportJsonToString;
     exports.isPassingExpectations = isPassingExpectations;
+    exports.isPipelinePrepared = isPipelinePrepared;
     exports.joinLlmExecutionTools = joinLlmExecutionTools;
+    exports.limitTotalUsage = limitTotalUsage;
     exports.pipelineJsonToString = pipelineJsonToString;
     exports.pipelineStringToJson = pipelineStringToJson;
     exports.pipelineStringToJsonSync = pipelineStringToJsonSync;
     exports.prepareKnowledgeFromMarkdown = prepareKnowledgeFromMarkdown;
+    exports.prepareKnowledgePieces = prepareKnowledgePieces;
+    exports.preparePersona = preparePersona;
     exports.preparePipeline = preparePipeline;
+    exports.prepareTemplates = prepareTemplates;
     exports.prettifyPipelineString = prettifyPipelineString;
     exports.stringifyPipelineJson = stringifyPipelineJson;
     exports.unpreparePipeline = unpreparePipeline;