@promptbook/core 0.84.0-21 → 0.84.0-9

package/esm/index.es.js

@@ -3,13 +3,13 @@ import { format } from 'prettier';
 import parserHtml from 'prettier/parser-html';
 import { forTime } from 'waitasecond';
 import { unparse, parse } from 'papaparse';
-import hexEncoder from 'crypto-js/enc-hex';
-import sha256 from 'crypto-js/sha256';
-import { basename, join, dirname } from 'path';
+import { join, basename } from 'path';
 import { SHA256 } from 'crypto-js';
-import { lookup, extension } from 'mime-types';
+import hexEncoder from 'crypto-js/enc-hex';
+import { lookup } from 'mime-types';
 import moment from 'moment';
 import colors from 'colors';
+import sha256 from 'crypto-js/sha256';
 
 // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
 /**
@@ -25,7 +25,7 @@ var BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-var PROMPTBOOK_ENGINE_VERSION = '0.84.0-20';
+var PROMPTBOOK_ENGINE_VERSION = '0.84.0-8';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -178,94 +178,22 @@ function collectionToJson(collection) {
  */
 
 /**
- * Checks if value is valid email
- *
- * @public exported from `@promptbook/utils`
- */
-function isValidEmail(email) {
-    if (typeof email !== 'string') {
-        return false;
-    }
-    if (email.split('\n').length > 1) {
-        return false;
-    }
-    return /^.+@.+\..+$/.test(email);
-}
-
-/**
- * Tests if given string is valid URL.
+ * Function isValidJsonString will tell you if the string is valid JSON or not
  *
- * Note: This does not check if the file exists only if the path is valid
  * @public exported from `@promptbook/utils`
  */
-function isValidFilePath(filename) {
-    if (typeof filename !== 'string') {
-        return false;
-    }
-    if (filename.split('\n').length > 1) {
-        return false;
-    }
-    if (filename.split(' ').length >
-        5 /* <- TODO: [🧠][🈷] Make some better non-arbitrary way how to distinct filenames from informational texts */) {
-        return false;
-    }
-    var filenameSlashes = filename.split('\\').join('/');
-    // Absolute Unix path: /hello.txt
-    if (/^(\/)/i.test(filenameSlashes)) {
-        // console.log(filename, 'Absolute Unix path: /hello.txt');
-        return true;
-    }
-    // Absolute Windows path: /hello.txt
-    if (/^([A-Z]{1,2}:\/?)\//i.test(filenameSlashes)) {
-        // console.log(filename, 'Absolute Windows path: /hello.txt');
-        return true;
-    }
-    // Relative path: ./hello.txt
-    if (/^(\.\.?\/)+/i.test(filenameSlashes)) {
-        // console.log(filename, 'Relative path: ./hello.txt');
-        return true;
-    }
-    // Allow paths like foo/hello
-    if (/^[^/]+\/[^/]+/i.test(filenameSlashes)) {
-        // console.log(filename, 'Allow paths like foo/hello');
-        return true;
-    }
-    // Allow paths like hello.book
-    if (/^[^/]+\.[^/]+$/i.test(filenameSlashes)) {
-        // console.log(filename, 'Allow paths like hello.book');
+function isValidJsonString(value /* <- [👨‍⚖️] */) {
+    try {
+        JSON.parse(value);
         return true;
     }
-    return false;
-}
-/**
- * TODO: [🍏] Implement for MacOs
- */
-
-/**
- * Tests if given string is valid URL.
- *
- * Note: Dataurl are considered perfectly valid.
- * 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') {
-        return false;
-    }
-    try {
-        if (url.startsWith('blob:')) {
-            url = url.replace(/^blob:/, '');
+    catch (error) {
+        if (!(error instanceof Error)) {
+            throw error;
         }
-        var urlObject = new URL(url /* because fail is handled */);
-        if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
+        if (error.message.includes('Unexpected token')) {
             return false;
         }
-        return true;
-    }
-    catch (error) {
         return false;
     }
 }
@@ -289,27 +217,6 @@ var ParseError = /** @class */ (function (_super) {
  * TODO: Maybe split `ParseError` and `ApplyError`
  */
 
-/**
- * Function isValidJsonString will tell you if the string is valid JSON or not
- *
- * @public exported from `@promptbook/utils`
- */
-function isValidJsonString(value /* <- [👨‍⚖️] */) {
-    try {
-        JSON.parse(value);
-        return true;
-    }
-    catch (error) {
-        if (!(error instanceof Error)) {
-            throw error;
-        }
-        if (error.message.includes('Unexpected token')) {
-            return false;
-        }
-        return false;
-    }
-}
-
 /**
  * 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.
@@ -323,15 +230,6 @@ function validatePipelineString(pipelineString) {
     if (isValidJsonString(pipelineString)) {
         throw new ParseError('Expected a book, but got a JSON string');
     }
-    else if (isValidUrl(pipelineString)) {
-        throw new ParseError("Expected a book, but got just the URL \"".concat(pipelineString, "\""));
-    }
-    else if (isValidFilePath(pipelineString)) {
-        throw new ParseError("Expected a book, but got just the file path \"".concat(pipelineString, "\""));
-    }
-    else if (isValidEmail(pipelineString)) {
-        throw new ParseError("Expected a book, but got just the email \"".concat(pipelineString, "\""));
-    }
     // <- TODO: Implement the validation + add tests when the pipeline logic considered as invalid
     return pipelineString;
 }
@@ -672,24 +570,6 @@ var DEFAULT_BOOK_TITLE = "\u2728 Untitled Book";
  * @public exported from `@promptbook/core`
  */
 var DEFAULT_TASK_TITLE = "Task";
-/**
- * When the title of the prompt task is not provided, the default title is used
- *
- * @public exported from `@promptbook/core`
- */
-var DEFAULT_PROMPT_TASK_TITLE = "Prompt";
-/**
- * When the pipeline is flat and no name of return parameter is provided, this name is used
- *
- * @public exported from `@promptbook/core`
- */
-var DEFAULT_BOOK_OUTPUT_PARAMETER_NAME = 'result';
-/**
- * Maximum file size limit
- *
- * @public exported from `@promptbook/core`
- */
-var DEFAULT_MAX_FILE_SIZE = 100 * 1024 * 1024; // 100MB
 // <- TODO: [🧠] Better system for generator warnings - not always "code" and "by `@promptbook/cli`"
 /**
  * The maximum number of iterations for a loops
@@ -770,14 +650,6 @@ var DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL = 200;
  */
 var DEFAULT_BOOKS_DIRNAME = './books';
 // <- TODO: [🕝] Make also `BOOKS_DIRNAME_ALTERNATIVES`
-/**
- * Where to store the temporary downloads
- *
- * Note: When the folder does not exist, it is created recursively
- *
- * @public exported from `@promptbook/core`
- */
-var DEFAULT_DOWNLOAD_CACHE_DIRNAME = './.promptbook/download-cache';
 /**
  * Where to store the cache of executions for promptbook CLI
  *
@@ -785,7 +657,7 @@ var DEFAULT_DOWNLOAD_CACHE_DIRNAME = './.promptbook/download-cache';
  *
  * @public exported from `@promptbook/core`
  */
-var DEFAULT_EXECUTION_CACHE_DIRNAME = './.promptbook/execution-cache';
+var DEFAULT_EXECUTIONS_CACHE_DIRNAME = './.promptbook/executions-cache';
 /**
  * Where to store the scrape cache
  *
@@ -1311,6 +1183,35 @@ function isUrlOnPrivateNetwork(url) {
     return isHostnameOnPrivateNetwork(url.hostname);
 }
 
+/**
+ * Tests if given string is valid URL.
+ *
+ * Note: Dataurl are considered perfectly valid.
+ * 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') {
+        return false;
+    }
+    try {
+        if (url.startsWith('blob:')) {
+            url = url.replace(/^blob:/, '');
+        }
+        var urlObject = new URL(url /* because fail is handled */);
+        if (!['http:', 'https:', 'data:'].includes(urlObject.protocol)) {
+            return false;
+        }
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+
 /**
  * Tests if given string is valid pipeline URL URL.
  *
@@ -2269,28 +2170,12 @@ function deserializeError(error) {
 /**
  * Asserts that the execution of a Promptbook is successful
  *
- * Note: If there are only warnings, the execution is still successful but the warnings are logged in the console
- *
  * @param executionResult - The partial result of the Promptbook execution
  * @throws {PipelineExecutionError} If the execution is not successful or if multiple errors occurred
  * @public exported from `@promptbook/core`
  */
 function assertsExecutionSuccessful(executionResult) {
-    var e_1, _a;
-    var isSuccessful = executionResult.isSuccessful, errors = executionResult.errors, warnings = executionResult.warnings;
-    try {
-        for (var warnings_1 = __values(warnings), warnings_1_1 = warnings_1.next(); !warnings_1_1.done; warnings_1_1 = warnings_1.next()) {
-            var warning = warnings_1_1.value;
-            console.warn(warning.message);
-        }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (warnings_1_1 && !warnings_1_1.done && (_a = warnings_1.return)) _a.call(warnings_1);
-        }
-        finally { if (e_1) throw e_1.error; }
-    }
+    var isSuccessful = executionResult.isSuccessful, errors = executionResult.errors;
     if (isSuccessful === true) {
         return;
     }
@@ -3300,7 +3185,7 @@ var MultipleLlmExecutionTools = /** @class */ (function () {
                         if (!(error_1 instanceof Error) || error_1 instanceof UnexpectedError) {
                             throw error_1;
                         }
-                        errors.push({ llmExecutionTools: llmExecutionTools, error: error_1 });
+                        errors.push(error_1);
                         return [3 /*break*/, 13];
                     case 13:
                         _b = _a.next();
@@ -3327,10 +3212,7 @@ var MultipleLlmExecutionTools = /** @class */ (function () {
                             //     2) AnthropicClaude throw PipelineExecutionError: Parameter `{knowledge}` is not defined
                             //     3) ...
                             spaceTrim(function (block) { return "\n                          All execution tools failed:\n\n                          ".concat(block(errors
-                                .map(function (_a, i) {
-                                var error = _a.error, llmExecutionTools = _a.llmExecutionTools;
-                                return "".concat(i + 1, ") **").concat(llmExecutionTools.title, "** thrown **").concat(error.name || 'Error', ":** ").concat(error.message);
-                            })
+                                .map(function (error, i) { return "".concat(i + 1, ") **").concat(error.name || 'Error', ":** ").concat(error.message); })
                                 .join('\n')), "\n\n                    "); }));
                         }
                         else if (this.llmExecutionTools.length === 0) {
@@ -5778,15 +5660,6 @@ function knowledgeSourceContentToName(knowledgeSourceContent) {
  * TODO: [🐱‍🐉][🧠] Make some smart crop NOT source-i-m-pavol-a-develop-... BUT source-i-m-pavol-a-developer-...
  */
 
-/**
- * @@@
- *
- * @private for `FileCacheStorage`
- */
-function nameToSubfolderPath(name) {
-    return [name.substr(0, 1).toLowerCase(), name.substr(1, 1).toLowerCase()];
-}
-
 /**
  * Convert file extension to mime type
  *
@@ -5843,55 +5716,53 @@ function isFileExisting(filename, fs) {
  */
 
 /**
- * Convert mime type to file extension
- *
- * Note: If the mime type is invalid, `null` is returned
- *
- * @private within the repository
- */
-function mimeTypeToExtension(value) {
-    return extension(value) || null;
-}
-
-/**
- * Removes emojis from a string and fix whitespaces
- *
- * @param text with emojis
- * @returns text without emojis
- * @public exported from `@promptbook/utils`
- */
-function removeEmojis(text) {
-    // Replace emojis (and also ZWJ sequence) with hyphens
-    text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
-    text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
-    text = text.replace(/(\p{Extended_Pictographic})(\u{200D}\p{Extended_Pictographic})*/gu, '$1');
-    text = text.replace(/\p{Extended_Pictographic}/gu, '');
-    return text;
-}
-
-/**
- * @@@
+ * Tests if given string is valid URL.
  *
- * @param value @@@
- * @returns @@@
- * @example @@@
+ * Note: This does not check if the file exists only if the path is valid
  * @public exported from `@promptbook/utils`
  */
-function titleToName(value) {
-    if (isValidUrl(value)) {
-        value = value.replace(/^https?:\/\//, '');
-        value = value.replace(/\.html$/, '');
+function isValidFilePath(filename) {
+    if (typeof filename !== 'string') {
+        return false;
     }
-    else if (isValidFilePath(value)) {
-        value = basename(value);
-        // Note: Keeping extension in the name
+    if (filename.split('\n').length > 1) {
+        return false;
     }
-    value = value.split('/').join('-');
-    value = removeEmojis(value);
-    value = normalizeToKebabCase(value);
-    // TODO: [🧠] Maybe warn or add some padding to short name which are not good identifiers
-    return value;
+    if (filename.split(' ').length >
+        5 /* <- TODO: [🧠][🈷] Make some better non-arbitrary way how to distinct filenames from informational texts */) {
+        return false;
+    }
+    var filenameSlashes = filename.split('\\').join('/');
+    // Absolute Unix path: /hello.txt
+    if (/^(\/)/i.test(filenameSlashes)) {
+        // console.log(filename, 'Absolute Unix path: /hello.txt');
+        return true;
+    }
+    // Absolute Windows path: /hello.txt
+    if (/^([A-Z]{1,2}:\/?)\//i.test(filenameSlashes)) {
+        // console.log(filename, 'Absolute Windows path: /hello.txt');
+        return true;
+    }
+    // Relative path: ./hello.txt
+    if (/^(\.\.?\/)+/i.test(filenameSlashes)) {
+        // console.log(filename, 'Relative path: ./hello.txt');
+        return true;
+    }
+    // Allow paths like foo/hello
+    if (/^[^/]+\/[^/]+/i.test(filenameSlashes)) {
+        // console.log(filename, 'Allow paths like foo/hello');
+        return true;
+    }
+    // Allow paths like hello.book
+    if (/^[^/]+\.[^/]+$/i.test(filenameSlashes)) {
+        // console.log(filename, 'Allow paths like hello.book');
+        return true;
+    }
+    return false;
 }
+/**
+ * TODO: [🍏] Implement for MacOs
+ */
 
 /**
  * The built-in `fetch' function with a lightweight error handling wrapper as default fetch function used in Promptbook scrapers
@@ -5928,9 +5799,9 @@ var scraperFetch = function (url, init) { return __awaiter(void 0, void 0, void
 function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
     var _a;
     return __awaiter(this, void 0, void 0, function () {
-        var _b, fetch, knowledgeSourceContent, name, _c, _d, rootDirname, url, response_1, mimeType, basename, hash, rootDirname_1, filepath, fileContent, _f, _g, filename_1, fileExtension, mimeType;
-        return __generator(this, function (_h) {
-            switch (_h.label) {
+        var _b, fetch, knowledgeSourceContent, name, _c, _d, rootDirname, url, response_1, mimeType, filename_1, fileExtension, mimeType;
+        return __generator(this, function (_f) {
+            switch (_f.label) {
                 case 0:
                     _b = tools.fetch, fetch = _b === void 0 ? scraperFetch : _b;
                     knowledgeSourceContent = knowledgeSource.knowledgeSourceContent;
@@ -5939,76 +5810,54 @@ function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
                     if (!name) {
                         name = knowledgeSourceContentToName(knowledgeSourceContent);
                     }
-                    if (!isValidUrl(knowledgeSourceContent)) return [3 /*break*/, 5];
+                    if (!isValidUrl(knowledgeSourceContent)) return [3 /*break*/, 2];
                     url = knowledgeSourceContent;
                     return [4 /*yield*/, fetch(url)];
                 case 1:
-                    response_1 = _h.sent();
+                    response_1 = _f.sent();
                     mimeType = ((_a = response_1.headers.get('content-type')) === null || _a === void 0 ? void 0 : _a.split(';')[0]) || 'text/html';
-                    if (tools.fs === undefined || !url.endsWith('.pdf' /* <- TODO: [💵] */)) {
-                        return [2 /*return*/, {
-                                source: name,
-                                filename: null,
-                                url: url,
-                                mimeType: mimeType,
-                                /*
-                              TODO: [🥽]
-                                  > async asBlob() {
-                                  >     // TODO: [👨🏻‍🤝‍👨🏻] This can be called multiple times BUT when called second time, response in already consumed
-                                  >     const content = await response.blob();
-                                  >     return content;
-                                  > },
-                              */
-                                asJson: function () {
-                                    return __awaiter(this, void 0, void 0, function () {
-                                        var content;
-                                        return __generator(this, function (_a) {
-                                            switch (_a.label) {
-                                                case 0: return [4 /*yield*/, response_1.json()];
-                                                case 1:
-                                                    content = _a.sent();
-                                                    return [2 /*return*/, content];
-                                            }
-                                        });
+                    return [2 /*return*/, {
+                            source: name,
+                            filename: null,
+                            url: url,
+                            mimeType: mimeType,
+                            /*
+                            TODO: [🥽]
+                                > async asBlob() {
+                                >     // TODO: [👨🏻‍🤝‍👨🏻] This can be called multiple times BUT when called second time, response in already consumed
+                                >     const content = await response.blob();
+                                >     return content;
+                                > },
+                            */
+                            asJson: function () {
+                                return __awaiter(this, void 0, void 0, function () {
+                                    var content;
+                                    return __generator(this, function (_a) {
+                                        switch (_a.label) {
+                                            case 0: return [4 /*yield*/, response_1.json()];
+                                            case 1:
+                                                content = _a.sent();
+                                                return [2 /*return*/, content];
+                                        }
                                     });
-                                },
-                                asText: function () {
-                                    return __awaiter(this, void 0, void 0, function () {
-                                        var content;
-                                        return __generator(this, function (_a) {
-                                            switch (_a.label) {
-                                                case 0: return [4 /*yield*/, response_1.text()];
-                                                case 1:
-                                                    content = _a.sent();
-                                                    return [2 /*return*/, content];
-                                            }
-                                        });
+                                });
+                            },
+                            asText: function () {
+                                return __awaiter(this, void 0, void 0, function () {
+                                    var content;
+                                    return __generator(this, function (_a) {
+                                        switch (_a.label) {
+                                            case 0: return [4 /*yield*/, response_1.text()];
+                                            case 1:
+                                                content = _a.sent();
+                                                return [2 /*return*/, content];
+                                        }
                                     });
-                                },
-                            }];
-                    }
-                    basename = url.split('/').pop() || titleToName(url);
-                    hash = sha256(hexEncoder.parse(url)).toString( /* hex */);
-                    rootDirname_1 = join(process.cwd(), DEFAULT_DOWNLOAD_CACHE_DIRNAME);
-                    filepath = join.apply(void 0, __spreadArray(__spreadArray([], __read(nameToSubfolderPath(hash /* <- TODO: [🎎] Maybe add some SHA256 prefix */)), false), ["".concat(basename.substring(0, MAX_FILENAME_LENGTH), ".").concat(mimeTypeToExtension(mimeType))], false));
-                    return [4 /*yield*/, tools.fs.mkdir(dirname(join(rootDirname_1, filepath)), { recursive: true })];
+                                });
+                            },
+                        }];
                 case 2:
-                    _h.sent();
-                    _g = (_f = Buffer).from;
-                    return [4 /*yield*/, response_1.arrayBuffer()];
-                case 3:
-                    fileContent = _g.apply(_f, [_h.sent()]);
-                    if (fileContent.length > DEFAULT_MAX_FILE_SIZE /* <- TODO: Allow to pass different value to remote server */) {
-                        throw new LimitReachedError("File is too large (".concat(Math.round(fileContent.length / 1024 / 1024), "MB). Maximum allowed size is ").concat(Math.round(DEFAULT_MAX_FILE_SIZE / 1024 / 1024), "MB."));
-                    }
-                    return [4 /*yield*/, tools.fs.writeFile(join(rootDirname_1, filepath), fileContent)];
-                case 4:
-                    _h.sent();
-                    // TODO: [💵] Check the file security
-                    // TODO: [🧹][🧠] Delete the file after the scraping is done
-                    return [2 /*return*/, makeKnowledgeSourceHandler({ name: name, knowledgeSourceContent: filepath }, tools, __assign(__assign({}, options), { rootDirname: rootDirname_1 }))];
-                case 5:
-                    if (!isValidFilePath(knowledgeSourceContent)) return [3 /*break*/, 7];
+                    if (!isValidFilePath(knowledgeSourceContent)) return [3 /*break*/, 4];
                     if (tools.fs === undefined) {
                         throw new EnvironmentMismatchError('Can not import file knowledge without filesystem tools');
                         //          <- TODO: [🧠] What is the best error type here`
@@ -6021,8 +5870,8 @@ function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
                     fileExtension = getFileExtension(filename_1);
                     mimeType = extensionToMimeType(fileExtension || '');
                     return [4 /*yield*/, isFileExisting(filename_1, tools.fs)];
-                case 6:
-                    if (!(_h.sent())) {
+                case 3:
+                    if (!(_f.sent())) {
                         throw new NotFoundError(spaceTrim(function (block) { return "\n                          Can not make source handler for file which does not exist:\n\n                          File:\n                          ".concat(block(knowledgeSourceContent), "\n\n                          Full file path:\n                          ").concat(block(filename_1), "\n                      "); }));
                     }
                     // TODO: [🧠][😿] Test security file - file is scoped to the project (BUT maybe do this in `filesystemTools`)
@@ -6068,7 +5917,7 @@ function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
                                 });
                             },
                         }];
-                case 7: return [2 /*return*/, {
+                case 4: return [2 /*return*/, {
                         source: name,
                         filename: null,
                         url: null,
@@ -7179,6 +7028,22 @@ function normalizeTo_camelCase(text, _isFirstLetterCapital) {
  * TODO: [🌺] Use some intermediate util splitWords
  */
 
+/**
+ * Removes emojis from a string and fix whitespaces
+ *
+ * @param text with emojis
+ * @returns text without emojis
+ * @public exported from `@promptbook/utils`
+ */
+function removeEmojis(text) {
+    // Replace emojis (and also ZWJ sequence) with hyphens
+    text = text.replace(/(\p{Extended_Pictographic})\p{Modifier_Symbol}/gu, '$1');
+    text = text.replace(/(\p{Extended_Pictographic})[\u{FE00}-\u{FE0F}]/gu, '$1');
+    text = text.replace(/(\p{Extended_Pictographic})(\u{200D}\p{Extended_Pictographic})*/gu, '$1');
+    text = text.replace(/\p{Extended_Pictographic}/gu, '');
+    return text;
+}
+
 /**
  * Removes quotes from a string
  *
@@ -9038,10 +8903,7 @@ var QuickChatbotHla = {
             description: 'Chatbot response',
             isInput: false,
             isOutput: true,
-            exampleValues: [
-                'Hello, how can I help you?',
-                // <- TODO: [🧠] Make this dynamic, async, prepare-phase HLAs
-            ],
+            exampleValues: ['Hello, I am a Pavol`s virtual avatar. How can I help you?'],
         });
         // TODO: Use spaceTrim in multiline strings
         $pipelineJson.tasks.push({
@@ -9129,15 +8991,12 @@ function isFlatPipeline(pipelineString) {
     pipelineString = removeMarkdownComments(pipelineString);
     pipelineString = spaceTrim(pipelineString);
     var isMarkdownBeginningWithHeadline = pipelineString.startsWith('# ');
-    //const isLastLineReturnStatement = pipelineString.split('\n').pop()!.split('`').join('').startsWith('->');
-    var isBacktickBlockUsed = pipelineString.includes('```');
-    var isQuoteBlocksUsed = /^>\s+/m.test(pipelineString);
-    var isBlocksUsed = isBacktickBlockUsed || isQuoteBlocksUsed;
-    // TODO: [🧉] Also (double)check
+    var isLastLineReturnStatement = pipelineString.split('\n').pop().split('`').join('').startsWith('->');
+    // TODO: Also (double)check
     // > const usedCommands
     // > const isBlocksUsed
     // > const returnStatementCount
-    var isFlat = !isMarkdownBeginningWithHeadline && !isBlocksUsed; /* && isLastLineReturnStatement */
+    var isFlat = !isMarkdownBeginningWithHeadline && isLastLineReturnStatement;
     return isFlat;
 }
 
@@ -9151,26 +9010,9 @@ function deflatePipeline(pipelineString) {
         return pipelineString;
     }
     var pipelineStringLines = pipelineString.split('\n');
-    var potentialReturnStatement = pipelineStringLines.pop();
-    var returnStatement;
-    if (/(-|=)>\s*\{.*\}/.test(potentialReturnStatement)) {
-        // Note: Last line is return statement
-        returnStatement = potentialReturnStatement;
-    }
-    else {
-        // Note: Last line is not a return statement
-        returnStatement = "-> {".concat(DEFAULT_BOOK_OUTPUT_PARAMETER_NAME, "}");
-        pipelineStringLines.push(potentialReturnStatement);
-    }
+    var returnStatement = pipelineStringLines.pop();
     var prompt = spaceTrim(pipelineStringLines.join('\n'));
-    var quotedPrompt;
-    if (prompt.split('\n').length <= 1) {
-        quotedPrompt = "> ".concat(prompt);
-    }
-    else {
-        quotedPrompt = spaceTrim(function (block) { return "\n                ```\n                ".concat(block(prompt.split('`').join('\\`')), "\n                ```\n            "); });
-    }
-    pipelineString = validatePipelineString(spaceTrim(function (block) { return "\n                # ".concat(DEFAULT_BOOK_TITLE, "\n\n                ## Prompt\n\n                ").concat(block(quotedPrompt), "\n\n                ").concat(returnStatement, "\n            "); }));
+    pipelineString = validatePipelineString(spaceTrim(function (block) { return "\n                # ".concat(DEFAULT_BOOK_TITLE, "\n\n                ## Prompt\n\n                ```\n                ").concat(block(prompt), "\n                ```\n\n                ").concat(returnStatement, "\n            "); }));
     // <- TODO: Maybe use book` notation
     return pipelineString;
 }
@@ -9393,6 +9235,30 @@ function flattenMarkdown(markdown) {
  *       NOW we are working just with markdown string and its good enough
  */
 
+/**
+ * @@@
+ *
+ * @param value @@@
+ * @returns @@@
+ * @example @@@
+ * @public exported from `@promptbook/utils`
+ */
+function titleToName(value) {
+    if (isValidUrl(value)) {
+        value = value.replace(/^https?:\/\//, '');
+        value = value.replace(/\.html$/, '');
+    }
+    else if (isValidFilePath(value)) {
+        value = basename(value);
+        // Note: Keeping extension in the name
+    }
+    value = value.split('/').join('-');
+    value = removeEmojis(value);
+    value = normalizeToKebabCase(value);
+    // TODO: [🧠] Maybe warn or add some padding to short name which are not good identifiers
+    return value;
+}
+
 /**
  * Compile pipeline from string (markdown) format to JSON format synchronously
  *
@@ -11045,55 +10911,6 @@ var _AzureOpenAiMetadataRegistration = $llmToolsMetadataRegister.register({
  */
 var $isRunningInJest = new Function("\n    try {\n        return process.env.JEST_WORKER_ID !== undefined;\n    } catch (e) {\n        return false;\n    }\n");
 
-/**
- * Registration of LLM provider metadata
- *
- * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools
- *
- * @public exported from `@promptbook/core`
- * @public exported from `@promptbook/wizzard`
- * @public exported from `@promptbook/cli`
- */
-var _DeepseekMetadataRegistration = $llmToolsMetadataRegister.register({
-    title: 'Deepseek',
-    packageName: '@promptbook/deepseek',
-    className: 'DeepseekExecutionTools',
-    envVariables: ['DEEPSEEK_GENERATIVE_AI_API_KEY'],
-    getBoilerplateConfiguration: function () {
-        return {
-            title: 'Deepseek (boilerplate)',
-            packageName: '@promptbook/deepseek',
-            className: 'DeepseekExecutionTools',
-            options: {
-                apiKey: 'AI',
-            },
-        };
-    },
-    createConfigurationFromEnv: function (env) {
-        if ($isRunningInJest()
-        // <- TODO: Maybe check `env.JEST_WORKER_ID` directly here or pass `env` into `$isRunningInJest`
-        ) {
-            // Note: [🔘] Maybe same problem as Gemini
-            return null;
-        }
-        // Note: Note using `process.env` BUT `env` to pass in the environment variables dynamically
-        if (typeof env.DEEPSEEK_GENERATIVE_AI_API_KEY === 'string') {
-            return {
-                title: 'Deepseek (from env)',
-                packageName: '@promptbook/deepseek',
-                className: 'DeepseekExecutionTools',
-                options: {
-                    apiKey: env.DEEPSEEK_GENERATIVE_AI_API_KEY,
-                },
-            };
-        }
-        return null;
-    },
-});
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
-
 /**
  * Registration of LLM provider metadata
  *
@@ -11258,14 +11075,13 @@ function isValidPipelineString(pipelineString) {
 /**
  * Tag function for notating a prompt as template literal
  *
- * Note: There are 3 similar functions:
+ * Note: There are 2 similar functions:
  * 1) `prompt` for notating single prompt exported from `@promptbook/utils`
- * 2) `promptTemplate` alias for `prompt`
- * 3) `book` for notating and validating entire books exported from `@promptbook/utils`
+ * 1) `book` for notating and validating entire books exported from `@promptbook/utils`
  *
- * @param strings
- * @param values
- * @returns the prompt string
+ * @param strings @@@
+ * @param values @@@
+ * @returns the pipeline string
  * @public exported from `@promptbook/utils`
  */
 function prompt(strings) {
@@ -11276,14 +11092,10 @@ function prompt(strings) {
     if (values.length === 0) {
         return spaceTrim(strings.join(''));
     }
-    var stringsWithHiddenParameters = strings.map(function (stringsItem) {
-        // TODO: [0] DRY
-        return stringsItem.split('{').join("".concat(REPLACING_NONCE, "beginbracket")).split('}').join("".concat(REPLACING_NONCE, "endbracket"));
-    });
     var placeholderParameterNames = values.map(function (value, i) { return "".concat(REPLACING_NONCE).concat(i); });
     var parameters = Object.fromEntries(values.map(function (value, i) { return [placeholderParameterNames[i], value]; }));
     // Combine strings and values
-    var pipelineString = stringsWithHiddenParameters.reduce(function (result, stringsItem, i) {
+    var pipelineString = strings.reduce(function (result, stringsItem, i) {
         return placeholderParameterNames[i] === undefined
             ? "".concat(result).concat(stringsItem)
             : "".concat(result).concat(stringsItem, "{").concat(placeholderParameterNames[i], "}");
@@ -11299,12 +11111,6 @@ function prompt(strings) {
         console.error({ pipelineString: pipelineString, parameters: parameters, placeholderParameterNames: placeholderParameterNames, error: error });
         throw new UnexpectedError(spaceTrim(function (block) { return "\n                    Internal error in prompt template literal\n                  \n                    ".concat(block(JSON.stringify({ strings: strings, values: values }, null, 4)), "}\n                  \n                "); }));
     }
-    // TODO: [0] DRY
-    pipelineString = pipelineString
-        .split("".concat(REPLACING_NONCE, "beginbracket"))
-        .join('{')
-        .split("".concat(REPLACING_NONCE, "endbracket"))
-        .join('}');
     return pipelineString;
 }
 /**
@@ -11315,10 +11121,9 @@ function prompt(strings) {
 /**
  * Tag function for notating a pipeline with a book\`...\ notation as template literal
  *
- * Note: There are 3 similar functions:
+ * Note: There are 2 similar functions:
  * 1) `prompt` for notating single prompt exported from `@promptbook/utils`
- * 2) `promptTemplate` alias for `prompt`
- * 3) `book` for notating and validating entire books exported from `@promptbook/utils`
+ * 1) `book` for notating and validating entire books exported from `@promptbook/utils`
  *
  * @param strings @@@
  * @param values @@@
@@ -11478,7 +11283,7 @@ var markitdownScraperMetadata = $deepFreeze({
     className: 'MarkitdownScraper',
     mimeTypes: [
         'application/pdf',
-        // TODO: [💵] Make priority for scrapers and than analyze which mime-types can Markitdown scrape and allow all mime types here:
+        // TODO: Make priority for scrapers and than allow all mime types here:
         // 'text/html',
         // 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
     ],
@@ -11640,5 +11445,5 @@ var PrefixStorage = /** @class */ (function () {
     return PrefixStorage;
 }());
 
-export { $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, ADMIN_EMAIL, ADMIN_GITHUB_NAME, AbstractFormatError, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateError, BoilerplateFormfactorDefinition, CLAIM, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CsvFormatDefinition, CsvFormatError, DEFAULT_BOOKS_DIRNAME, DEFAULT_BOOK_OUTPUT_PARAMETER_NAME, DEFAULT_BOOK_TITLE, DEFAULT_CSV_SETTINGS, DEFAULT_DOWNLOAD_CACHE_DIRNAME, DEFAULT_EXECUTION_CACHE_DIRNAME, DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_PROMPT_TASK_TITLE, DEFAULT_REMOTE_URL, DEFAULT_REMOTE_URL_PATH, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TASK_TITLE, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FORMFACTOR_DEFINITIONS, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, ImageGeneratorFormfactorDefinition, KnowledgeScrapeError, LOGO_DARK_SRC, LOGO_LIGHT_SRC, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NonTaskSectionTypes, NotFoundError, NotYetImplementedError, ORDER_OF_PIPELINE_JSON, PROMPTBOOK_ENGINE_VERSION, PROMPTBOOK_ERRORS, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, RESERVED_PARAMETER_NAMES, SET_IS_VERBOSE, SectionTypes, SheetsFormfactorDefinition, TaskTypes, TextFormatDefinition, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UnexpectedError, ZERO_USAGE, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _BoilerplateScraperMetadataRegistration, _DeepseekMetadataRegistration, _DocumentScraperMetadataRegistration, _GoogleMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _MarkitdownScraperMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, addUsage, assertsExecutionSuccessful, book, cacheLlmTools, collectionToJson, compilePipeline, countTotalUsage, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createLlmToolsFromConfiguration, createPipelineExecutor, createSubcollection, embeddingVectorToString, executionReportJsonToString, extractParameterNamesFromTask, getPipelineInterface, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, isValidPipelineString, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, parsePipeline, pipelineJsonToString, prepareKnowledgePieces, preparePersona, preparePipeline, prepareTasks, prettifyPipelineString, unpreparePipeline, usageToHuman, usageToWorktime, validatePipeline, validatePipelineString };
+export { $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, ADMIN_EMAIL, ADMIN_GITHUB_NAME, AbstractFormatError, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateError, BoilerplateFormfactorDefinition, CLAIM, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CsvFormatDefinition, CsvFormatError, DEFAULT_BOOKS_DIRNAME, DEFAULT_BOOK_TITLE, DEFAULT_CSV_SETTINGS, DEFAULT_EXECUTIONS_CACHE_DIRNAME, DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_REMOTE_URL, DEFAULT_REMOTE_URL_PATH, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TASK_TITLE, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FORMFACTOR_DEFINITIONS, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, ImageGeneratorFormfactorDefinition, KnowledgeScrapeError, LOGO_DARK_SRC, LOGO_LIGHT_SRC, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NonTaskSectionTypes, NotFoundError, NotYetImplementedError, ORDER_OF_PIPELINE_JSON, PROMPTBOOK_ENGINE_VERSION, PROMPTBOOK_ERRORS, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, RESERVED_PARAMETER_NAMES, SET_IS_VERBOSE, SectionTypes, SheetsFormfactorDefinition, TaskTypes, TextFormatDefinition, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UnexpectedError, ZERO_USAGE, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _BoilerplateScraperMetadataRegistration, _DocumentScraperMetadataRegistration, _GoogleMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _MarkitdownScraperMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, addUsage, assertsExecutionSuccessful, book, cacheLlmTools, collectionToJson, compilePipeline, countTotalUsage, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createLlmToolsFromConfiguration, createPipelineExecutor, createSubcollection, embeddingVectorToString, executionReportJsonToString, extractParameterNamesFromTask, getPipelineInterface, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, isValidPipelineString, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, parsePipeline, pipelineJsonToString, prepareKnowledgePieces, preparePersona, preparePipeline, prepareTasks, prettifyPipelineString, unpreparePipeline, usageToHuman, usageToWorktime, validatePipeline, validatePipelineString };
 //# sourceMappingURL=index.es.js.map