@promptbook/cli 0.80.0 → 0.81.0-12

package/esm/index.es.js

@@ -29,15 +29,17 @@ import { Converter } from 'showdown';
 /**
  * The version of the Book language
  *
+ * @generated
  * @see https://github.com/webgptorg/book
  */
 var BOOK_LANGUAGE_VERSION = '1.0.0';
 /**
  * The version of the Promptbook engine
  *
+ * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-var PROMPTBOOK_ENGINE_VERSION = '0.80.0-1';
+var PROMPTBOOK_ENGINE_VERSION = '0.81.0-11';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -235,6 +237,26 @@ var GENERATOR_WARNING_BY_PROMPTBOOK_CLI = "\u26A0\uFE0F WARNING: This code has b
  * @private within the repository - too low-level in comparison with other `MAX_...`
  */
 var LOOP_LIMIT = 1000;
+/**
+ * Strings to represent various values in the context of parameter values
+ *
+ * @public exported from `@promptbook/utils`
+ */
+var VALUE_STRINGS = {
+    empty: '(nothing; empty string)',
+    null: '(no value; null)',
+    undefined: '(unknown value; undefined)',
+    nan: '(not a number; NaN)',
+    infinity: '(infinity; ∞)',
+    negativeInfinity: '(negative infinity; -∞)',
+    unserializable: '(unserializable value)',
+};
+/**
+ * Small number limit
+ *
+ * @public exported from `@promptbook/utils`
+ */
+var SMALL_NUMBER = 0.001;
 /**
  * Timeout for the connections in milliseconds
  *
@@ -353,6 +375,12 @@ var DEFAULT_IS_VERBOSE = false;
  * @public exported from `@promptbook/core`
  */
 var DEFAULT_IS_AUTO_INSTALLED = false;
+/**
+ * Function name for generated function via `ptbk make` to get the pipeline collection
+ *
+ * @public exported from `@promptbook/core`
+ */
+var DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME = "getPipelineCollection";
 /**
  * @@@
  *
@@ -488,6 +516,40 @@ function $provideFilesystemForNode(options) {
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  */
 
+/**
+ * Make error report URL for the given error
+ *
+ * @private !!!!!!
+ */
+function getErrorReportUrl(error) {
+    var report = {
+        title: "\uD83D\uDC1C Error report from ".concat(NAME),
+        body: spaceTrim(function (block) { return "\n\n\n            `".concat(error.name || 'Error', "` has occurred in the [").concat(NAME, "], please look into it @").concat(ADMIN_GITHUB_NAME, ".\n\n            ```\n            ").concat(block(error.message || '(no error message)'), "\n            ```\n\n\n            ## More info:\n\n            - **Promptbook engine version:** ").concat(PROMPTBOOK_ENGINE_VERSION, "\n            - **Book language version:** ").concat(BOOK_LANGUAGE_VERSION, "\n            - **Time:** ").concat(new Date().toISOString(), "\n\n            <details>\n            <summary>Stack trace:</summary>\n\n            ## Stack trace:\n\n            ```stacktrace\n            ").concat(block(error.stack || '(empty)'), "\n            ```\n            </details>\n\n        "); }),
+    };
+    var reportUrl = new URL("https://github.com/webgptorg/promptbook/issues/new");
+    reportUrl.searchParams.set('labels', 'bug');
+    reportUrl.searchParams.set('assignees', ADMIN_GITHUB_NAME);
+    reportUrl.searchParams.set('title', report.title);
+    reportUrl.searchParams.set('body', report.body);
+    return reportUrl;
+}
+
+/**
+ * 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);
+    function UnexpectedError(message) {
+        var _this = _super.call(this, spaceTrim$1(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the pipeline collection\n\n                    Please report issue:\n                    ").concat(block(getErrorReportUrl(new Error(message)).href), "\n\n                    Or contact us on ").concat(ADMIN_EMAIL, "\n\n                "); })) || this;
+        _this.name = 'UnexpectedError';
+        Object.setPrototypeOf(_this, UnexpectedError.prototype);
+        return _this;
+    }
+    return UnexpectedError;
+}(Error));
+
 /**
  * Orders JSON object by keys
  *
@@ -538,40 +600,6 @@ function $deepFreeze(objectValue) {
  * TODO: [🧠] Is there a way how to meaningfully test this utility
  */
 
-/**
- * Make error report URL for the given error
- *
- * @private !!!!!!
- */
-function getErrorReportUrl(error) {
-    var report = {
-        title: "\uD83D\uDC1C Error report from ".concat(NAME),
-        body: spaceTrim(function (block) { return "\n\n\n            `".concat(error.name || 'Error', "` has occurred in the [").concat(NAME, "], please look into it @").concat(ADMIN_GITHUB_NAME, ".\n\n            ```\n            ").concat(block(error.message || '(no error message)'), "\n            ```\n\n\n            ## More info:\n\n            - **Promptbook engine version:** ").concat(PROMPTBOOK_ENGINE_VERSION, "\n            - **Book language version:** ").concat(BOOK_LANGUAGE_VERSION, "\n            - **Time:** ").concat(new Date().toISOString(), "\n\n            <details>\n            <summary>Stack trace:</summary>\n\n            ## Stack trace:\n\n            ```stacktrace\n            ").concat(block(error.stack || '(empty)'), "\n            ```\n            </details>\n\n        "); }),
-    };
-    var reportUrl = new URL("https://github.com/webgptorg/promptbook/issues/new");
-    reportUrl.searchParams.set('labels', 'bug');
-    reportUrl.searchParams.set('assignees', ADMIN_GITHUB_NAME);
-    reportUrl.searchParams.set('title', report.title);
-    reportUrl.searchParams.set('body', report.body);
-    return reportUrl;
-}
-
-/**
- * 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);
-    function UnexpectedError(message) {
-        var _this = _super.call(this, spaceTrim$1(function (block) { return "\n                    ".concat(block(message), "\n\n                    Note: This error should not happen.\n                    It's probbably a bug in the pipeline collection\n\n                    Please report issue:\n                    ").concat(block(getErrorReportUrl(new Error(message)).href), "\n\n                    Or contact us on ").concat(ADMIN_EMAIL, "\n\n                "); })) || this;
-        _this.name = 'UnexpectedError';
-        Object.setPrototypeOf(_this, UnexpectedError.prototype);
-        return _this;
-    }
-    return UnexpectedError;
-}(Error));
-
 /**
  * Checks if the value is [🚉] serializable as JSON
  * If not, throws an UnexpectedError with a rich error message and tracking
@@ -662,7 +690,7 @@ function checkSerializableAsJson(options) {
                 if (!(error instanceof Error)) {
                     throw error;
                 }
-                throw new UnexpectedError(spaceTrim(function (block) { return "\n                            `".concat(name, "` is not serializable\n\n                            ").concat(block(error.toString()), "\n\n                            Additional message for `").concat(name, "`:\n                            ").concat(block(message || '(nothing)'), "\n                        "); }));
+                throw new UnexpectedError(spaceTrim(function (block) { return "\n                            `".concat(name, "` is not serializable\n\n                            ").concat(block(error.stack || error.message), "\n\n                            Additional message for `").concat(name, "`:\n                            ").concat(block(message || '(nothing)'), "\n                        "); }));
             }
             /*
             TODO: [0] Is there some more elegant way to check circular references?
@@ -760,6 +788,7 @@ function exportJson(options) {
  * @public exported from `@promptbook/core`
  */
 var ORDER_OF_PIPELINE_JSON = [
+    // Note: [🍙] In this order will be pipeline serialized
     'title',
     'pipelineUrl',
     'bookVersion',
@@ -771,6 +800,7 @@ var ORDER_OF_PIPELINE_JSON = [
     'preparations',
     'knowledgeSources',
     'knowledgePieces',
+    'sources', // <- TODO: [🧠] Where should the `sources` be
 ];
 /**
  * Nonce which is used for replacing things in strings
@@ -854,7 +884,7 @@ function isSerializableAsJson(value) {
  * 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`
+ * @public exported from `@promptbook/editable`
  */
 function stringifyPipelineJson(pipeline) {
     if (!isSerializableAsJson(pipeline)) {
@@ -937,21 +967,44 @@ 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');
         return true;
     }
     return false;
 }
+/**
+ * TODO: [🍏] Implement for MacOs
+ */
 
 /**
  * Tests if given string is valid URL.
@@ -2560,8 +2613,11 @@ function $provideLlmToolsFromEnv(options) {
     }
     var configuration = $provideLlmToolsConfigurationFromEnv();
     if (configuration.length === 0) {
+        if ($llmToolsMetadataRegister.list().length === 0) {
+            throw new UnexpectedError(spaceTrim(function (block) { return "\n                        No LLM tools registered, this is probably a bug in the Promptbook library\n\n                        ".concat(block($registeredLlmToolsMessage()), "}\n                    "); }));
+        }
         // TODO: [🥃]
-        throw new Error(spaceTrim(function (block) { return "\n                    No LLM tools found in the environment\n\n                    Please set one of environment variables:\n                    - OPENAI_API_KEY\n                    - ANTHROPIC_CLAUDE_API_KEY\n\n                    ".concat(block($registeredLlmToolsMessage()), "}\n                "); }));
+        throw new Error(spaceTrim(function (block) { return "\n                    No LLM tools found in the environment\n\n                    ".concat(block($registeredLlmToolsMessage()), "}\n                "); }));
     }
     return createLlmToolsFromConfiguration(configuration, options);
 }
@@ -2580,9 +2636,9 @@ function $provideLlmToolsFromEnv(options) {
  *
  * @private within the repository - for CLI utils
  */
-function $provideLlmToolsForCli(options) {
+function $provideLlmToolsForWizzardOrCli(options) {
     if (!$isRunningInNode()) {
-        throw new EnvironmentMismatchError('Function `$provideLlmToolsForTestingAndScriptsAndPlayground` works only in Node.js environment');
+        throw new EnvironmentMismatchError('Function `$provideLlmToolsForWizzardOrCli` works only in Node.js environment');
     }
     var isCacheReloaded = (options !== null && options !== void 0 ? options : {}).isCacheReloaded;
     return cacheLlmTools(countTotalUsage(
@@ -2595,7 +2651,7 @@ function $provideLlmToolsForCli(options) {
     });
 }
 /**
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
  * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  * TODO: [🥃] Allow `ptbk make` without llm tools
  * TODO: This should be maybe not under `_common` but under `utils-internal` / `utils/internal`
@@ -2613,7 +2669,7 @@ function initializeListModelsCommand(program) {
     listModelsCommand.description(spaceTrim("\n            List all available and configured LLM models\n      "));
     listModelsCommand.action(function () { return __awaiter(_this, void 0, void 0, function () {
         return __generator(this, function (_a) {
-            $provideLlmToolsForCli({});
+            $provideLlmToolsForWizzardOrCli({});
             // <- Note: Providing LLM tools will make a side effect of registering all available LLM tools to show the message
             console.info($registeredLlmToolsMessage());
             return [2 /*return*/, process.exit(0)];
@@ -2744,7 +2800,7 @@ function forEachAsync(array, options, callbackfunction) {
     });
 }
 
-var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sourceFile:"./books/prepare-knowledge-from-markdown.book.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sourceFile:"./books/prepare-knowledge-keywords.book.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sourceFile:"./books/prepare-knowledge-title.book.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book.md",formfactorName:"GENERIC",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Example\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",resultingParameterName:"modelRequirements",format:"JSON",dependentParameterNames:["availableModelNames","personaDescription"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sourceFile:"./books/prepare-persona.book.md"}];
+var PipelineCollection = [{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgeContent",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledgePieces",description:"The knowledge JSON object",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}",resultingParameterName:"knowledgePieces",dependentParameterNames:["knowledgeContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Knowledge from Markdown\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.book.md`\n-   INPUT PARAMETER `{knowledgeContent}` Markdown document content\n-   OUTPUT PARAMETER `{knowledgePieces}` The knowledge JSON object\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, extract the important knowledge from the document.\n\n# Rules\n\n-   Make pieces of information concise, clear, and easy to understand\n-   One piece of information should be approximately 1 paragraph\n-   Divide the paragraphs by markdown horizontal lines ---\n-   Omit irrelevant information\n-   Group redundant information\n-   Write just extracted information, nothing else\n\n# The document\n\nTake information from this document:\n\n> {knowledgeContent}\n```\n\n`-> {knowledgePieces}`\n"}],sourceFile:"./books/prepare-knowledge-from-markdown.book.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-keywords.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}",resultingParameterName:"keywords",dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Keywords\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-keywords.book.md`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{keywords}` Keywords separated by comma\n\n## Knowledge\n\n<!-- TODO: [🍆] -FORMAT JSON -->\n\n```markdown\nYou are experienced data researcher, detect the important keywords in the document.\n\n# Rules\n\n-   Write just keywords separated by comma\n\n# The document\n\nTake information from this document:\n\n> {knowledgePieceContent}\n```\n\n`-> {keywords}`\n"}],sourceFile:"./books/prepare-knowledge-keywords.book.md"},{title:"Prepare Title",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-title.book.md",formfactorName:"GENERIC",parameters:[{name:"knowledgePieceContent",description:"The content",isInput:true,isOutput:false},{name:"title",description:"The title of the document",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"knowledge",title:"Knowledge",content:"You are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}",resultingParameterName:"title",expectations:{words:{min:1,max:8}},dependentParameterNames:["knowledgePieceContent"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Title\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-knowledge-title.book.md`\n-   INPUT PARAMETER `{knowledgePieceContent}` The content\n-   OUTPUT PARAMETER `{title}` The title of the document\n\n## Knowledge\n\n-   EXPECT MIN 1 WORD\n-   EXPECT MAX 8 WORDS\n\n```markdown\nYou are experienced content creator, write best title for the document.\n\n# Rules\n\n-   Write just title, nothing else\n-   Title should be concise and clear\n-   Write maximum 5 words for the title\n\n# The document\n\n> {knowledgePieceContent}\n```\n\n`-> {title}`\n"}],sourceFile:"./books/prepare-knowledge-title.book.md"},{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-persona.book.md",formfactorName:"GENERIC",parameters:[{name:"availableModelNames",description:"List of available model names separated by comma (,)",isInput:true,isOutput:false},{name:"personaDescription",description:"Description of the persona",isInput:true,isOutput:false},{name:"modelRequirements",description:"Specific requirements for the model",isInput:false,isOutput:true}],tasks:[{taskType:"PROMPT_TASK",name:"make-model-requirements",title:"Make modelRequirements",content:"You are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Example\n\n```json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n```\n\n## Instructions\n\n-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}",resultingParameterName:"modelRequirements",format:"JSON",dependentParameterNames:["availableModelNames","personaDescription"]}],personas:[],preparations:[],knowledgeSources:[],knowledgePieces:[],sources:[{type:"BOOK",path:null,content:"# Prepare Keywords\n\n-   PIPELINE URL `https://promptbook.studio/promptbook/prepare-persona.book.md`\n-   INPUT PARAMETER `{availableModelNames}` List of available model names separated by comma (,)\n-   INPUT PARAMETER `{personaDescription}` Description of the persona\n-   OUTPUT PARAMETER `{modelRequirements}` Specific requirements for the model\n\n## Make modelRequirements\n\n-   FORMAT JSON\n\n```markdown\nYou are experienced AI engineer, you need to create virtual assistant.\nWrite\n\n## Example\n\n\\`\\`\\`json\n{\n\"modelName\": \"gpt-4o\",\n\"systemMessage\": \"You are experienced AI engineer and helpfull assistant.\",\n\"temperature\": 0.7\n}\n\\`\\`\\`\n\n## Instructions\n\n-   Your output format is JSON object\n-   Write just the JSON object, no other text should be present\n-   It contains the following keys:\n    -   `modelName`: The name of the model to use\n    -   `systemMessage`: The system message to provide context to the model\n    -   `temperature`: The sampling temperature to use\n\n### Key `modelName`\n\nPick from the following models:\n\n-   {availableModelNames}\n\n### Key `systemMessage`\n\nThe system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.\n\nFor example:\n\n> You are an experienced AI engineer and helpful assistant.\n\n> You are a friendly and knowledgeable chatbot.\n\n### Key `temperature`\n\nThe sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.\n\nYou can pick a value between 0 and 2. For example:\n\n-   `0.1`: Low temperature, extremely conservative and deterministic\n-   `0.5`: Medium temperature, balanced between conservative and creative\n-   `1.0`: High temperature, creative and bit random\n-   `1.5`: Very high temperature, extremely creative and often chaotic and unpredictable\n-   `2.0`: Maximum temperature, completely random and unpredictable, for some extreme creative use cases\n\n# The assistant\n\nTake this description of the persona:\n\n> {personaDescription}\n```\n\n`-> {modelRequirements}`\n"}],sourceFile:"./books/prepare-persona.book.md"}];
 
 /**
  * Prettify the html code
@@ -3140,9 +3196,6 @@ function isValidPipelineUrl(url) {
     if (!url.startsWith('https://')) {
         return false;
     }
-    if (!(url.endsWith('.book.md') || url.endsWith('.book') || url.endsWith('.book.md') || url.endsWith('.ptbk'))) {
-        return false;
-    }
     if (url.includes('#')) {
         // TODO: [🐠]
         return false;
@@ -3872,6 +3925,81 @@ function isPipelinePrepared(pipeline) {
  *     - [♨] Are tasks prepared
  */
 
+/**
+ * Format either small or big number
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function numberToString(value) {
+    if (value === 0) {
+        return '0';
+    }
+    else if (Number.isNaN(value)) {
+        return VALUE_STRINGS.nan;
+    }
+    else if (value === Infinity) {
+        return VALUE_STRINGS.infinity;
+    }
+    else if (value === -Infinity) {
+        return VALUE_STRINGS.negativeInfinity;
+    }
+    for (var exponent = 0; exponent < 15; exponent++) {
+        var factor = Math.pow(10, exponent);
+        var valueRounded = Math.round(value * factor) / factor;
+        if (Math.abs(value - valueRounded) / value < SMALL_NUMBER) {
+            return valueRounded.toFixed(exponent);
+        }
+    }
+    return value.toString();
+}
+
+/**
+ * Function `valueToString` will convert the given value to string
+ * This is useful and used in the `templateParameters` function
+ *
+ * Note: This function is not just calling `toString` method
+ *       It's more complex and can handle this conversion specifically for LLM models
+ *       See `VALUE_STRINGS`
+ *
+ * Note: There are 2 similar functions
+ * - `valueToString` converts value to string for LLM models as human-readable string
+ * - `asSerializable` converts value to string to preserve full information to be able to convert it back
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function valueToString(value) {
+    try {
+        if (value === '') {
+            return VALUE_STRINGS.empty;
+        }
+        else if (value === null) {
+            return VALUE_STRINGS.null;
+        }
+        else if (value === undefined) {
+            return VALUE_STRINGS.undefined;
+        }
+        else if (typeof value === 'string') {
+            return value;
+        }
+        else if (typeof value === 'number') {
+            return numberToString(value);
+        }
+        else if (value instanceof Date) {
+            return value.toISOString();
+        }
+        else {
+            return JSON.stringify(value);
+        }
+    }
+    catch (error) {
+        if (!(error instanceof Error)) {
+            throw error;
+        }
+        console.error(error);
+        return VALUE_STRINGS.unserializable;
+    }
+}
+
 /**
  * Serializes an error into a [🚉] JSON-serializable object
  *
@@ -3943,7 +4071,7 @@ function extractVariablesFromScript(script) {
         if (!(error instanceof Error)) {
             throw error;
         }
-        throw new ParseError(spaceTrim$1(function (block) { return "\n                    Can not extract variables from the script\n\n                    ".concat(block(error.toString()), "}\n\n\n                    Found variables:\n\n                    ").concat(Array.from(variables)
+        throw new ParseError(spaceTrim$1(function (block) { return "\n                    Can not extract variables from the script\n                    ".concat(block(error.stack || error.message), "\n\n                    Found variables:\n                    ").concat(Array.from(variables)
             .map(function (variableName, i) { return "".concat(i + 1, ") ").concat(variableName); })
             .join('\n'), "\n\n\n                    The script:\n\n                    ```javascript\n                    ").concat(block(originalScript), "\n                    ```\n                "); }));
     }
@@ -4584,13 +4712,16 @@ function arrayableToArray(input) {
 /**
  * Replaces parameters in template with values from parameters object
  *
+ * Note: This function is not places strings into string,
+ *       It's more complex and can handle this operation specifically for LLM models
+ *
  * @param template the template with parameters in {curly} braces
  * @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) {
+function templateParameters(template, parameters) {
     var e_1, _a;
     try {
         for (var _b = __values(Object.entries(parameters)), _c = _b.next(); !_c.done; _c = _b.next()) {
@@ -4616,7 +4747,7 @@ function replaceParameters(template, parameters) {
     var loopLimit = LOOP_LIMIT;
     var _loop_1 = function () {
         if (loopLimit-- < 0) {
-            throw new LimitReachedError('Loop limit reached during parameters replacement in `replaceParameters`');
+            throw new LimitReachedError('Loop limit reached during parameters replacement in `templateParameters`');
         }
         var precol = match.groups.precol;
         var parameterName = match.groups.parameterName;
@@ -4633,7 +4764,7 @@ function replaceParameters(template, parameters) {
         if (parameterValue === undefined) {
             throw new PipelineExecutionError("Parameter `{".concat(parameterName, "}` is not defined"));
         }
-        parameterValue = parameterValue.toString();
+        parameterValue = valueToString(parameterValue);
         if (parameterValue.includes('\n') && /^\s*\W{0,3}\s*$/.test(precol)) {
             parameterValue = parameterValue
                 .split('\n')
@@ -4868,7 +4999,7 @@ function executeAttempts(options) {
                                     }
                                     return [3 /*break*/, 24];
                                 case 2:
-                                    $ongoingTaskResult.$resultString = replaceParameters(preparedContent, parameters);
+                                    $ongoingTaskResult.$resultString = templateParameters(preparedContent, parameters);
                                     return [3 /*break*/, 25];
                                 case 3:
                                     modelRequirements = __assign(__assign({ modelVariant: 'CHAT' }, (preparedPipeline.defaultModelRequirements || {})), (task.modelRequirements || {}));
@@ -4991,8 +5122,8 @@ function executeAttempts(options) {
                                     _j = $ongoingTaskResult;
                                     return [4 /*yield*/, tools.userInterface.promptDialog($deepFreeze({
                                             promptTitle: task.title,
-                                            promptMessage: replaceParameters(task.description || '', parameters),
-                                            defaultValue: replaceParameters(preparedContent, parameters),
+                                            promptMessage: templateParameters(task.description || '', parameters),
+                                            defaultValue: templateParameters(preparedContent, parameters),
                                             // TODO: [🧠] !! Figure out how to define placeholder in .book.md file
                                             placeholder: undefined,
                                             priority: priority,
@@ -5116,7 +5247,7 @@ function executeAttempts(options) {
                                     if (!isJokerAttempt &&
                                         task.taskType === 'PROMPT_TASK' &&
                                         $ongoingTaskResult.$prompt
-                                    //    <- Note:  [2] When some expected parameter is not defined, error will occur in replaceParameters
+                                    //    <- Note:  [2] When some expected parameter is not defined, error will occur in templateParameters
                                     //              In that case we don’t want to make a report about it because it’s not a llm execution error
                                     ) {
                                         // TODO: [🧠] Maybe put other taskTypes into report
@@ -5693,7 +5824,10 @@ function executePipeline(options) {
                     finally { if (e_2) throw e_2.error; }
                     return [7 /*endfinally*/];
                 case 19:
-                    parametersToPass = inputParameters;
+                    parametersToPass = Object.fromEntries(Object.entries(inputParameters).map(function (_a) {
+                        var _b = __read(_a, 2), key = _b[0], value = _b[1];
+                        return [key, valueToString(value)];
+                    }));
                     _g.label = 20;
                 case 20:
                     _g.trys.push([20, 25, , 28]);
@@ -6180,6 +6314,33 @@ function getFileExtension(value) {
     return match ? match[1].toLowerCase() : null;
 }
 
+/**
+ * The built-in `fetch' function with a lightweight error handling wrapper as default fetch function used in Promptbook scrapers
+ *
+ * @private as default `fetch` function used in Promptbook scrapers
+ */
+var scraperFetch = function (url, init) { return __awaiter(void 0, void 0, void 0, function () {
+    var error_1;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                _a.trys.push([0, 2, , 3]);
+                return [4 /*yield*/, fetch(url, init)];
+            case 1: return [2 /*return*/, _a.sent()];
+            case 2:
+                error_1 = _a.sent();
+                if (!(error_1 instanceof Error)) {
+                    throw error_1;
+                }
+                throw new KnowledgeScrapeError(spaceTrim(function (block) { return "\n                    Can not fetch \"".concat(url, "\"\n\n                    Fetch error:\n                    ").concat(block(error_1.message), "\n\n                "); }));
+            case 3: return [2 /*return*/];
+        }
+    });
+}); };
+/**
+ * TODO: [🧠] Maybe rename because it is not used only for scrapers but also in `$getCompiledBook`
+ */
+
 /**
  * @@@
  *
@@ -6188,13 +6349,14 @@ function getFileExtension(value) {
 function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
     var _a;
     return __awaiter(this, void 0, void 0, function () {
-        var sourceContent, name, _b, _c, rootDirname, url, response_1, mimeType, filename_1, fileExtension, mimeType;
-        return __generator(this, function (_e) {
-            switch (_e.label) {
+        var _b, fetch, sourceContent, 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;
                     sourceContent = knowledgeSource.sourceContent;
                     name = knowledgeSource.name;
-                    _b = options || {}, _c = _b.rootDirname, rootDirname = _c === void 0 ? null : _c, _b.isVerbose;
+                    _c = options || {}, _d = _c.rootDirname, rootDirname = _d === void 0 ? null : _d, _c.isVerbose;
                     if (!name) {
                         name = sourceContentToName(sourceContent);
                     }
@@ -6202,7 +6364,7 @@ function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
                     url = sourceContent;
                     return [4 /*yield*/, fetch(url)];
                 case 1:
-                    response_1 = _e.sent();
+                    response_1 = _f.sent();
                     mimeType = ((_a = response_1.headers.get('content-type')) === null || _a === void 0 ? void 0 : _a.split(';')[0]) || 'text/html';
                     return [2 /*return*/, {
                             source: name,
@@ -6245,7 +6407,7 @@ function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
                             },
                         }];
                 case 2:
-                    if (!(isValidFilePath(sourceContent) || /\.[a-z]{1,10}$/i.exec(sourceContent))) return [3 /*break*/, 4];
+                    if (!isValidFilePath(sourceContent)) 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`
@@ -6259,8 +6421,8 @@ function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
                     mimeType = extensionToMimeType(fileExtension || '');
                     return [4 /*yield*/, isFileExisting(filename_1, tools.fs)];
                 case 3:
-                    if (!(_e.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(filename_1), "\n                      "); }));
+                    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(sourceContent), "\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`)
                     return [2 /*return*/, {
@@ -9522,6 +9684,14 @@ function precompilePipeline(pipelineString) {
         knowledgePieces: [],
         personas: [],
         preparations: [],
+        sources: [
+            {
+                type: 'BOOK',
+                path: null,
+                // <- TODO: !!!!!! Pass here path of the file
+                content: pipelineString,
+            },
+        ],
     };
     function getPipelineIdentification() {
         // Note: This is a 😐 implementation of [🚞]
@@ -9536,6 +9706,8 @@ function precompilePipeline(pipelineString) {
     }
     // =============================================================
     // Note: 1️⃣ Parsing of the markdown into object
+    // ==============
+    // Note: 1️⃣◽1️⃣ Remove #!shebang and comments
     if (pipelineString.startsWith('#!')) {
         var _g = __read(pipelineString.split('\n')), shebangLine_1 = _g[0], restLines = _g.slice(1);
         if (!(shebangLine_1 || '').includes('ptbk')) {
@@ -9544,10 +9716,33 @@ function precompilePipeline(pipelineString) {
         pipelineString = restLines.join('\n');
     }
     pipelineString = removeContentComments(pipelineString);
+    pipelineString = spaceTrim$1(pipelineString);
+    // ==============
+    // Note: 1️⃣◽2️⃣ Process flat pipeline
+    var isMarkdownBeginningWithHeadline = pipelineString.startsWith('# ');
+    var isLastLineReturnStatement = pipelineString.split('\n').pop().split('`').join('').startsWith('->');
+    // TODO: Also (double)check
+    // > const usedCommands
+    // > const isBlocksUsed
+    // > const returnStatementCount
+    var isFlatPipeline = !isMarkdownBeginningWithHeadline && isLastLineReturnStatement;
+    // console.log({ isMarkdownBeginningWithHeadline, isLastLineReturnStatement, isFlatPipeline });
+    if (isFlatPipeline) {
+        var pipelineStringLines = pipelineString.split('\n');
+        var returnStatement_1 = pipelineStringLines.pop();
+        var prompt_1 = spaceTrim$1(pipelineStringLines.join('\n'));
+        pipelineString = spaceTrim$1(function (block) { return "\n                # ".concat(DEFAULT_TITLE /* <- TODO: !!!!!! Title for flat pipelines */, "\n\n                ## Prompt\n\n                ```\n                ").concat(block(prompt_1), "\n                ```\n\n                ").concat(returnStatement_1, "\n            "); });
+        // <- TODO: !!!!!! Use `book notation
+        // console.log(pipelineString);
+    }
+    // ==============
+    // Note: 1️⃣◽3️⃣ Parse the markdown
     pipelineString = flattenMarkdown(pipelineString) /* <- Note: [🥞] */;
     pipelineString = pipelineString.replaceAll(/`\{(?<parameterName>[a-z0-9_]+)\}`/gi, '{$<parameterName>}');
     pipelineString = pipelineString.replaceAll(/`->\s+\{(?<parameterName>[a-z0-9_]+)\}`/gi, '-> {$<parameterName>}');
     var _h = __read(splitMarkdownIntoSections(pipelineString).map(parseMarkdownSection)), pipelineHead = _h[0], pipelineSections = _h.slice(1); /* <- Note: [🥞] */
+    // ==============
+    // Note: 1️⃣◽4️⃣ Check markdown structure
     if (pipelineHead === undefined) {
         throw new UnexpectedError(spaceTrim$1(function (block) { return "\n                    Pipeline head is not defined\n\n                    ".concat(block(getPipelineIdentification()), "\n\n                    This should never happen, because the pipeline already flattened\n                "); }));
     }
@@ -9929,7 +10124,6 @@ function precompilePipeline(pipelineString) {
         $pipelineJson.formfactorName = 'GENERIC';
     }
     // =============================================================
-    // TODO: [🍙] Maybe do reorder of `$pipelineJson` here
     return exportJson({
         name: 'pipelineJson',
         message: "Result of `precompilePipeline`",
@@ -10346,53 +10540,140 @@ function $provideScrapersForNode(tools, options) {
  */
 
 /**
- * Extracts code block from markdown.
- *
- * - When there are multiple or no code blocks the function throws a `ParseError`
+ * Creates a Mermaid graph based on the promptbook
  *
- * Note: There are multiple simmilar function:
- * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
- * - `extractJsonBlock` extracts exactly one valid JSON code block
- * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
- * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+ * Note: The result is not wrapped in a Markdown code block
  *
- * @public exported from `@promptbook/markdown-utils`
- * @throws {ParseError} if there is not exactly one code block in the markdown
+ * @public exported from `@promptbook/utils`
  */
-function extractBlock(markdown) {
-    var content = extractOneBlockFromMarkdown(markdown).content;
-    return content;
+function renderPromptbookMermaid(pipelineJson, options) {
+    var _a = (options || {}).linkTask, linkTask = _a === void 0 ? function () { return null; } : _a;
+    var parameterNameToTaskName = function (parameterName) {
+        var parameter = pipelineJson.parameters.find(function (parameter) { return parameter.name === parameterName; });
+        if (!parameter) {
+            throw new UnexpectedError("Could not find {".concat(parameterName, "}"));
+            // <- TODO: !!!!!! This causes problems when {knowledge} and other reserved parameters are used
+        }
+        if (parameter.isInput) {
+            return 'input';
+        }
+        var task = pipelineJson.tasks.find(function (task) { return task.resultingParameterName === parameterName; });
+        if (!task) {
+            throw new Error("Could not find task for {".concat(parameterName, "}"));
+        }
+        return task.name || normalizeTo_camelCase('task-' + titleToName(task.title));
+    };
+    var promptbookMermaid = spaceTrim$1(function (block) { return "\n\n            %% \uD83D\uDD2E Tip: Open this on GitHub or in the VSCode website to see the Mermaid graph visually\n\n            flowchart LR\n              subgraph \"".concat(pipelineJson.title, "\"\n\n                  direction TB\n\n                  input((Input)):::input\n                  ").concat(block(pipelineJson.tasks
+        .flatMap(function (_a) {
+        var title = _a.title, dependentParameterNames = _a.dependentParameterNames, resultingParameterName = _a.resultingParameterName;
+        return __spreadArray([
+            "".concat(parameterNameToTaskName(resultingParameterName), "(\"").concat(title, "\")")
+        ], __read(dependentParameterNames.map(function (dependentParameterName) {
+            return "".concat(parameterNameToTaskName(dependentParameterName), "--\"{").concat(dependentParameterName, "}\"-->").concat(parameterNameToTaskName(resultingParameterName));
+        })), false);
+    })
+        .join('\n')), "\n\n                  ").concat(block(pipelineJson.parameters
+        .filter(function (_a) {
+        var isOutput = _a.isOutput;
+        return isOutput;
+    })
+        .map(function (_a) {
+        var name = _a.name;
+        return "".concat(parameterNameToTaskName(name), "--\"{").concat(name, "}\"-->output");
+    })
+        .join('\n')), "\n                  output((Output)):::output\n\n                  ").concat(block(pipelineJson.tasks
+        .map(function (task) {
+        var link = linkTask(task);
+        if (link === null) {
+            return '';
+        }
+        var href = link.href, title = link.title;
+        var taskName = parameterNameToTaskName(task.resultingParameterName);
+        return "click ".concat(taskName, " href \"").concat(href, "\" \"").concat(title, "\";");
+    })
+        .filter(function (line) { return line !== ''; })
+        .join('\n')), "\n\n                  classDef input color: grey;\n                  classDef output color: grey;\n\n              end;\n\n        "); });
+    return promptbookMermaid;
 }
+/**
+ * TODO: [🧠] !! FOREACH in mermaid graph
+ * TODO: [🧠] !! Knowledge in mermaid graph
+ * TODO: [🧠] !! Personas in mermaid graph
+ * TODO: Maybe use some Mermaid package instead of string templating
+ * TODO: [🕌] When more than 2 functionalities, split into separate functions
+ */
 
 /**
- * Makes first letter of a string uppercase
+ * Detects if the code is running in a browser environment in main thread (Not in a web worker)
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
  *
  * @public exported from `@promptbook/utils`
  */
-function decapitalize(word) {
-    return word.substring(0, 1).toLowerCase() + word.substring(1);
-}
+var $isRunningInBrowser = new Function("\n    try {\n        return this === window;\n    } catch (e) {\n        return false;\n    }\n");
 
 /**
- * @@@
+ * Detects if the code is running in jest environment
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
  *
- * @param name @@@
- * @returns @@@
- * @example @@@
  * @public exported from `@promptbook/utils`
  */
-function nameToUriPart(name) {
-    var uriPart = name;
-    uriPart = uriPart.toLowerCase();
-    uriPart = removeDiacritics(uriPart);
-    uriPart = uriPart.replace(/[^a-zA-Z0-9]+/g, '-');
-    uriPart = uriPart.replace(/^-+/, '');
-    uriPart = uriPart.replace(/-+$/, '');
-    return uriPart;
-}
+var $isRunningInJest = new Function("\n    try {\n        return process.env.JEST_WORKER_ID !== undefined;\n    } catch (e) {\n        return false;\n    }\n");
 
 /**
- * @@@
+ * Detects if the code is running in a web worker
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
+ *
+ * @public exported from `@promptbook/utils`
+ */
+var $isRunningInWebWorker = new Function("\n    try {\n        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {\n            return true;\n        } else {\n            return false;\n        }\n    } catch (e) {\n        return false;\n    }\n");
+
+/**
+ * Makes first letter of a string uppercase
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function decapitalize(word) {
+    return word.substring(0, 1).toLowerCase() + word.substring(1);
+}
+
+/**
+ * Parses keywords from a string
+ *
+ * @param {string} input
+ * @returns {Set} of keywords without diacritics in lowercase
+ * @public exported from `@promptbook/utils`
+ */
+function parseKeywordsFromString(input) {
+    var keywords = normalizeTo_SCREAMING_CASE(removeDiacritics(input))
+        .toLowerCase()
+        .split(/[^a-z0-9]+/gs)
+        .filter(function (value) { return value; });
+    return new Set(keywords);
+}
+
+/**
+ * @@@
+ *
+ * @param name @@@
+ * @returns @@@
+ * @example @@@
+ * @public exported from `@promptbook/utils`
+ */
+function nameToUriPart(name) {
+    var uriPart = name;
+    uriPart = uriPart.toLowerCase();
+    uriPart = removeDiacritics(uriPart);
+    uriPart = uriPart.replace(/[^a-zA-Z0-9]+/g, '-');
+    uriPart = uriPart.replace(/^-+/, '');
+    uriPart = uriPart.replace(/-+$/, '');
+    return uriPart;
+}
+
+/**
+ * @@@
  *
  * @param name @@@
  * @returns @@@
@@ -10426,21 +10707,6 @@ function normalizeWhitespaces(sentence) {
     return sentence.replace(/\s+/gs, ' ').trim();
 }
 
-/**
- * Parses keywords from a string
- *
- * @param {string} input
- * @returns {Set} of keywords without diacritics in lowercase
- * @public exported from `@promptbook/utils`
- */
-function parseKeywordsFromString(input) {
-    var keywords = normalizeTo_SCREAMING_CASE(removeDiacritics(input))
-        .toLowerCase()
-        .split(/[^a-z0-9]+/gs)
-        .filter(function (value) { return value; });
-    return new Set(keywords);
-}
-
 /**
  * Function trimCodeBlock will trim starting and ending code block from the string if it is present.
  *
@@ -10547,6 +10813,44 @@ function unwrapResult(text, options) {
  * TODO: [🧠] Should this also unwrap the (parenthesis)
  */
 
+/**
+ * Determines if the given path is a root path.
+ *
+ * Note: This does not check if the file exists only if the path is valid
+ * @public exported from `@promptbook/utils`
+ */
+function isPathRoot(value) {
+    if (value === '/') {
+        return true;
+    }
+    if (/^[A-Z]:\\$/i.test(value)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * TODO: [🍏] Make for MacOS paths
+ */
+
+/**
+ * Extracts code block from markdown.
+ *
+ * - When there are multiple or no code blocks the function throws a `ParseError`
+ *
+ * Note: There are multiple simmilar function:
+ * - `extractBlock` just extracts the content of the code block which is also used as build-in function for postprocessing
+ * - `extractJsonBlock` extracts exactly one valid JSON code block
+ * - `extractOneBlockFromMarkdown` extracts exactly one code block with language of the code block
+ * - `extractAllBlocksFromMarkdown` extracts all code blocks with language of the code block
+ *
+ * @public exported from `@promptbook/markdown-utils`
+ * @throws {ParseError} if there is not exactly one code block in the markdown
+ */
+function extractBlock(markdown) {
+    var content = extractOneBlockFromMarkdown(markdown).content;
+    return content;
+}
+
 /**
  * Does nothing, but preserves the function in the bundle
  * Compiler is tricked into thinking the function is used
@@ -10581,37 +10885,10 @@ function preserve(func) {
     }); })();
 }
 /**
+ * TODO: Probbably remove in favour of `keepImported`
  * TODO: !! [1] This maybe does memory leak
  */
 
-/**
- * Converts anything to string that can be used for debugging and logging
- *
- * @param value String value for logging
- * @private internal util
- */
-function unknownToString(value) {
-    if (value === undefined) {
-        return 'undefined';
-    }
-    else if (value === null) {
-        return 'null';
-    }
-    else if (['number', 'string', 'boolean'].includes(typeof value)) {
-        return typeof value + ' ' + value.toString();
-    }
-    else if (typeof value === 'object' && Array.isArray(value)) {
-        return 'array containing [' + value.map(function (item) { return unknownToString(item); }).join(', ') + ']';
-    }
-    else if (typeof value === 'object') {
-        // TODO: Maybe serialize the object
-        return 'object';
-    }
-    else {
-        return 'unknown (Search in promptbook code for [🔹])';
-    }
-}
-
 /**
  * ScriptExecutionTools for JavaScript implemented via eval
  *
@@ -10741,7 +11018,7 @@ var JavascriptEvalExecutionTools = /** @class */ (function () {
                     case 2:
                         result = _a.sent();
                         if (typeof result !== 'string') {
-                            throw new PipelineExecutionError("Script must return a string, but returned ".concat(unknownToString(result)));
+                            throw new PipelineExecutionError("Script must return a string, but returned ".concat(valueToString(result)));
                         }
                         return [3 /*break*/, 4];
                     case 3:
@@ -10768,7 +11045,7 @@ var JavascriptEvalExecutionTools = /** @class */ (function () {
                         throw error_1;
                     case 4:
                         if (typeof result !== 'string') {
-                            throw new PipelineExecutionError("Script must return a string, but ".concat(unknownToString(result)));
+                            throw new PipelineExecutionError("Script must return a string, but ".concat(valueToString(result)));
                         }
                         return [2 /*return*/, result];
                 }
@@ -11041,7 +11318,7 @@ function createCollectionFromPromise(promptbookSourcesPromiseOrFactory) {
  */
 function createCollectionFromDirectory(path, tools, options) {
     return __awaiter(this, void 0, void 0, function () {
-        var makedLibraryFilePath, _a, _b, isRecursive, _c, isVerbose, _d, isLazyLoaded, _e, isCrashedOnError, collection;
+        var madeLibraryFilePath, _a, _b, isRecursive, _c, isVerbose, _d, isLazyLoaded, _e, isCrashedOnError, collection;
         var _this = this;
         return __generator(this, function (_f) {
             switch (_f.label) {
@@ -11056,16 +11333,14 @@ function createCollectionFromDirectory(path, tools, options) {
                         throw new EnvironmentMismatchError('Can not create collection without filesystem tools');
                         //          <- TODO: [🧠] What is the best error type here`
                     }
-                    makedLibraryFilePath = join(path, "".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME
+                    madeLibraryFilePath = join(path, "".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME
                     // <- TODO: [🦒] Allow to override (pass different value into the function)
                     , ".json"));
-                    return [4 /*yield*/, isFileExisting(makedLibraryFilePath, tools.fs)];
+                    return [4 /*yield*/, isFileExisting(madeLibraryFilePath, tools.fs)];
                 case 3:
-                    if (!(_f.sent())) {
-                        console.info(colors.yellow("Tip: Prebuild your pipeline collection (file with supposed prebuild ".concat(makedLibraryFilePath, " not found) with CLI util \"ptbk make\" to speed up the collection creation.")));
-                    }
+                    if (!(_f.sent())) ;
                     else {
-                        colors.green("(In future, not implemented yet) Using your prebuild pipeline collection ".concat(makedLibraryFilePath));
+                        colors.green("(In future, not implemented yet) Using your compiled pipeline collection ".concat(madeLibraryFilePath));
                         // TODO: !! Implement;
                         // TODO: [🌗]
                     }
@@ -11085,10 +11360,10 @@ function createCollectionFromDirectory(path, tools, options) {
                                     // Note: First load all .book.json and then .book.md files
                                     //       .book.json can be prepared so it is faster to load
                                     fileNames.sort(function (a, b) {
-                                        if (a.endsWith('.book.json') && b.endsWith('.book.md')) {
+                                        if (a.endsWith('.json') && b.endsWith('.md')) {
                                             return -1;
                                         }
-                                        if (a.endsWith('.book.md') && b.endsWith('.book.json')) {
+                                        if (a.endsWith('.md') && b.endsWith('.json')) {
                                             return 1;
                                         }
                                         return 0;
@@ -11137,7 +11412,7 @@ function createCollectionFromDirectory(path, tools, options) {
                                                         // TODO: [👠] DRY
                                                         if (pipeline.pipelineUrl === undefined) {
                                                             if (isVerbose) {
-                                                                console.info(colors.red("Can not load pipeline from ".concat(fileName
+                                                                console.info(colors.yellow("Can not load pipeline from ".concat(fileName
                                                                     .split('\\')
                                                                     .join('/'), " because of missing URL")));
                                                             }
@@ -11315,16 +11590,21 @@ function initializeMakeCommand(program) {
     makeCommand.option('--validation', "Types of validations separated by comma (options \"logic\",\"imports\")", 'logic,imports');
     makeCommand.option('-r, --reload', "Call LLM models even if same prompt with result is in the cache", false);
     makeCommand.option('-v, --verbose', "Is output verbose", false);
-    makeCommand.option('-o, --out-file <path>', spaceTrim("\n            Where to save the builded collection\n\n            Note: If you keep it \"".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, "\" it will be saved in the root of the promptbook directory\n                  If you set it to a path, it will be saved in that path\n                  BUT you can use only one format and set correct extension\n        ")), DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME);
+    makeCommand.option('-o, --output <path>', spaceTrim("\n            Where to save the builded collection\n\n            Note: If you keep it \"".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, "\" it will be saved in the root of the promptbook directory\n                  If you set it to a path, it will be saved in that path\n                  BUT you can use only one format and set correct extension\n        ")), DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME);
+    makeCommand.option('-fn, --function-name <functionName>', spaceTrim("\n            Name of the function to get pipeline collection\n\n            Note: This can be used only with \"javascript\" or \"typescript\" format\n\n        "), DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME);
     makeCommand.action(function (path, _a) {
-        var projectName = _a.projectName, format = _a.format, validation = _a.validation, isCacheReloaded = _a.reload, isVerbose = _a.verbose, outFile = _a.outFile;
+        var projectName = _a.projectName, format = _a.format, functionName = _a.functionName, validation = _a.validation, isCacheReloaded = _a.reload, isVerbose = _a.verbose, output = _a.output;
         return __awaiter(_this, void 0, void 0, function () {
-            var formats, validations, prepareAndScrapeOptions, fs, llm, executables, tools, collection, validations_1, validations_1_1, validation_1, _b, _c, pipelineUrl, pipeline, e_1_1, e_2_1, collectionJson, collectionJsonString, collectionJsonItems, saveFile;
-            var _d, e_2, _e, e_1, _f;
+            var formats, validations, prepareAndScrapeOptions, fs, llm, executables, tools, collection, pipelinesUrls, validations_1, validations_1_1, validation_1, pipelinesUrls_1, pipelinesUrls_1_1, pipelineUrl, pipeline, e_1_1, e_2_1, collectionJson, collectionJsonString, collectionJsonItems, saveFile;
+            var _b, e_2, _c, e_1, _d;
             var _this = this;
-            return __generator(this, function (_g) {
-                switch (_g.label) {
+            return __generator(this, function (_e) {
+                switch (_e.label) {
                     case 0:
+                        if (!isValidJavascriptName(functionName)) {
+                            console.error(colors.red("Function name \"".concat(functionName, "\" is not valid javascript name")));
+                            return [2 /*return*/, process.exit(1)];
+                        }
                         formats = (format || '')
                             .split(',')
                             .map(function (_) { return _.trim(); })
@@ -11333,7 +11613,7 @@ function initializeMakeCommand(program) {
                             .split(',')
                             .map(function (_) { return _.trim(); })
                             .filter(function (_) { return _ !== ''; });
-                        if (outFile !== DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME && formats.length !== 1) {
+                        if (output !== DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME && formats.length !== 1) {
                             console.error(colors.red("You can only use one format if you specify --out-file"));
                             return [2 /*return*/, process.exit(1)];
                         }
@@ -11342,88 +11622,92 @@ function initializeMakeCommand(program) {
                             isCacheReloaded: isCacheReloaded,
                         };
                         fs = $provideFilesystemForNode(prepareAndScrapeOptions);
-                        llm = $provideLlmToolsForCli(prepareAndScrapeOptions);
+                        llm = $provideLlmToolsForWizzardOrCli(prepareAndScrapeOptions);
                         return [4 /*yield*/, $provideExecutablesForNode(prepareAndScrapeOptions)];
                     case 1:
-                        executables = _g.sent();
-                        _d = {
+                        executables = _e.sent();
+                        _b = {
                             llm: llm,
                             fs: fs
                         };
                         return [4 /*yield*/, $provideScrapersForNode({ fs: fs, llm: llm, executables: executables }, prepareAndScrapeOptions)];
                     case 2:
-                        tools = (_d.scrapers = _g.sent(),
-                            _d.script = [
+                        tools = (_b.scrapers = _e.sent(),
+                            _b.script = [
                             /*new JavascriptExecutionTools(options)*/
                             ],
-                            _d);
+                            _b);
                         return [4 /*yield*/, createCollectionFromDirectory(path, tools, {
                                 isVerbose: isVerbose,
                                 isRecursive: true,
                                 // <- TODO: [🍖] Add `intermediateFilesStrategy`
                             })];
                     case 3:
-                        collection = _g.sent();
-                        _g.label = 4;
+                        collection = _e.sent();
+                        return [4 /*yield*/, collection.listPipelines()];
                     case 4:
-                        _g.trys.push([4, 16, 17, 18]);
-                        validations_1 = __values(validations), validations_1_1 = validations_1.next();
-                        _g.label = 5;
+                        pipelinesUrls = _e.sent();
+                        if (pipelinesUrls.length === 0) {
+                            console.error(colors.red("No books found in \"".concat(path, "\"")));
+                            return [2 /*return*/, process.exit(1)];
+                        }
+                        _e.label = 5;
                     case 5:
+                        _e.trys.push([5, 16, 17, 18]);
+                        validations_1 = __values(validations), validations_1_1 = validations_1.next();
+                        _e.label = 6;
+                    case 6:
                         if (!!validations_1_1.done) return [3 /*break*/, 15];
                         validation_1 = validations_1_1.value;
-                        _g.label = 6;
-                    case 6:
-                        _g.trys.push([6, 12, 13, 14]);
-                        e_1 = void 0;
-                        return [4 /*yield*/, collection.listPipelines()];
+                        _e.label = 7;
                     case 7:
-                        _b = (__values.apply(void 0, [_g.sent()])), _c = _b.next();
-                        _g.label = 8;
+                        _e.trys.push([7, 12, 13, 14]);
+                        pipelinesUrls_1 = (e_1 = void 0, __values(pipelinesUrls)), pipelinesUrls_1_1 = pipelinesUrls_1.next();
+                        _e.label = 8;
                     case 8:
-                        if (!!_c.done) return [3 /*break*/, 11];
-                        pipelineUrl = _c.value;
+                        if (!!pipelinesUrls_1_1.done) return [3 /*break*/, 11];
+                        pipelineUrl = pipelinesUrls_1_1.value;
                         return [4 /*yield*/, collection.getPipelineByUrl(pipelineUrl)];
                     case 9:
-                        pipeline = _g.sent();
+                        pipeline = _e.sent();
                         if (validation_1 === 'logic') {
                             validatePipeline(pipeline);
                             if (isVerbose) {
                                 console.info(colors.cyan("Validated logic of ".concat(pipeline.pipelineUrl)));
                             }
                         }
-                        _g.label = 10;
+                        _e.label = 10;
                     case 10:
-                        _c = _b.next();
+                        pipelinesUrls_1_1 = pipelinesUrls_1.next();
                         return [3 /*break*/, 8];
                     case 11: return [3 /*break*/, 14];
                     case 12:
-                        e_1_1 = _g.sent();
+                        e_1_1 = _e.sent();
                         e_1 = { error: e_1_1 };
                         return [3 /*break*/, 14];
                     case 13:
                         try {
-                            if (_c && !_c.done && (_f = _b.return)) _f.call(_b);
+                            if (pipelinesUrls_1_1 && !pipelinesUrls_1_1.done && (_d = pipelinesUrls_1.return)) _d.call(pipelinesUrls_1);
                         }
                         finally { if (e_1) throw e_1.error; }
                         return [7 /*endfinally*/];
                     case 14:
                         validations_1_1 = validations_1.next();
-                        return [3 /*break*/, 5];
+                        return [3 /*break*/, 6];
                     case 15: return [3 /*break*/, 18];
                     case 16:
-                        e_2_1 = _g.sent();
+                        e_2_1 = _e.sent();
                         e_2 = { error: e_2_1 };
                         return [3 /*break*/, 18];
                     case 17:
                         try {
-                            if (validations_1_1 && !validations_1_1.done && (_e = validations_1.return)) _e.call(validations_1);
+                            if (validations_1_1 && !validations_1_1.done && (_c = validations_1.return)) _c.call(validations_1);
                         }
                         finally { if (e_2) throw e_2.error; }
                         return [7 /*endfinally*/];
                     case 18: return [4 /*yield*/, collectionToJson(collection)];
                     case 19:
-                        collectionJson = _g.sent();
+                        collectionJson = _e.sent();
                         collectionJsonString = stringifyPipelineJson(collectionJson).trim();
                         collectionJsonItems = (function () {
                             var firstChar = collectionJsonString.charAt(0);
@@ -11441,10 +11725,10 @@ function initializeMakeCommand(program) {
                             return __generator(this, function (_a) {
                                 switch (_a.label) {
                                     case 0:
-                                        filename = outFile !== DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME
-                                            ? outFile
+                                        filename = output !== DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME
+                                            ? output
                                             : join(path, "".concat(DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, ".").concat(extension));
-                                        if (!outFile.endsWith(".".concat(extension))) {
+                                        if (!output.endsWith(".".concat(extension))) {
                                             console.warn(colors.yellow("Warning: Extension of output file should be \"".concat(extension, "\"")));
                                         }
                                         return [4 /*yield*/, mkdir(dirname(filename), { recursive: true })];
@@ -11454,7 +11738,7 @@ function initializeMakeCommand(program) {
                                     case 2:
                                         _a.sent();
                                         // Note: Log despite of verbose mode
-                                        console.info(colors.green("Maked ".concat(filename.split('\\').join('/'))));
+                                        console.info(colors.green("Made ".concat(filename.split('\\').join('/'))));
                                         return [2 /*return*/];
                                 }
                             });
@@ -11463,22 +11747,22 @@ function initializeMakeCommand(program) {
                         formats = formats.filter(function (format) { return format !== 'json'; });
                         return [4 /*yield*/, saveFile('json', collectionJsonString)];
                     case 20:
-                        _g.sent();
-                        _g.label = 21;
+                        _e.sent();
+                        _e.label = 21;
                     case 21:
                         if (!(formats.includes('javascript') || formats.includes('js'))) return [3 /*break*/, 23];
                         formats = formats.filter(function (format) { return format !== 'javascript' && format !== 'js'; });
-                        return [4 /*yield*/, saveFile('js', spaceTrim(function (block) { return "\n                            // ".concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n\n                            import { createCollectionFromJson } from '@promptbook/core';\n\n                            /**\n                             * Pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @private internal cache for `getPipelineCollection`\n                             */\n                            let pipelineCollection = null;\n\n\n                            /**\n                             * Get pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                             */\n                            export function getPipelineCollection(){\n                                if(pipelineCollection===null){\n                                    pipelineCollection = createCollectionFromJson(\n                                        ").concat(block(collectionJsonItems), "\n                                    );\n                                }\n\n                                return pipelineCollection;\n                            }\n                        "); }))];
+                        return [4 /*yield*/, saveFile('js', spaceTrim(function (block) { return "\n                            // ".concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n\n                            import { createCollectionFromJson } from '@promptbook/core';\n\n                            /**\n                             * Pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @generated\n                             * @private internal cache for `").concat(functionName, "`\n                             */\n                            let pipelineCollection = null;\n\n\n                            /**\n                             * Get pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @generated\n                             * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                             */\n                            export function ").concat(functionName, "(){\n                                if(pipelineCollection===null){\n                                    pipelineCollection = createCollectionFromJson(\n                                        ").concat(block(collectionJsonItems), "\n                                    );\n                                }\n\n                                return pipelineCollection;\n                            }\n                        "); }))];
                     case 22:
-                        (_g.sent()) + '\n';
-                        _g.label = 23;
+                        (_e.sent()) + '\n';
+                        _e.label = 23;
                     case 23:
                         if (!(formats.includes('typescript') || formats.includes('ts'))) return [3 /*break*/, 25];
                         formats = formats.filter(function (format) { return format !== 'typescript' && format !== 'ts'; });
-                        return [4 /*yield*/, saveFile('ts', spaceTrim(function (block) { return "\n                            // ".concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n\n                            import { createCollectionFromJson } from '@promptbook/core';\n                            import type { PipelineCollection } from '@promptbook/types';\n\n                            /**\n                             * Pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @private internal cache for `getPipelineCollection`\n                             */\n                            let pipelineCollection: null | PipelineCollection = null;\n\n\n                            /**\n                             * Get pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                             */\n                            export function getPipelineCollection(): PipelineCollection{\n                                if(pipelineCollection===null){\n                                    pipelineCollection = createCollectionFromJson(\n                                        ").concat(block(collectionJsonItems), "\n                                    );\n                                }\n\n                                return pipelineCollection;\n                            }\n                        "); }) + '\n')];
+                        return [4 /*yield*/, saveFile('ts', spaceTrim(function (block) { return "\n                            // ".concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n\n                            import { createCollectionFromJson } from '@promptbook/core';\n                            import type { PipelineCollection } from '@promptbook/types';\n\n                            /**\n                             * Pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @private internal cache for `").concat(functionName, "`\n                             * @generated\n                             */\n                            let pipelineCollection: null | PipelineCollection = null;\n\n\n                            /**\n                             * Get pipeline collection for ").concat(projectName, "\n                             *\n                             * ").concat(block(GENERATOR_WARNING_BY_PROMPTBOOK_CLI), "\n                             *\n                             * @generated\n                             * @returns {PipelineCollection} Library of promptbooks for ").concat(projectName, "\n                             */\n                            export function ").concat(functionName, "(): PipelineCollection{\n                                if(pipelineCollection===null){\n\n                                    // TODO: !!!!!! Use book string literal notation\n                                    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n                                    pipelineCollection = (createCollectionFromJson as (..._: any) => PipelineCollection)(\n                                        ").concat(block(collectionJsonItems), "\n                                    );\n                                }\n\n                                return pipelineCollection;\n                            }\n                        "); }) + '\n')];
                     case 24:
-                        _g.sent();
-                        _g.label = 25;
+                        _e.sent();
+                        _e.label = 25;
                     case 25:
                         if (formats.length > 0) {
                             console.warn(colors.yellow("Format ".concat(formats.join(' and '), " is not supported")));
@@ -11529,70 +11813,6 @@ function addAutoGeneratedSection(content, options) {
  * TODO: [🏛] This can be part of markdown builder
  */
 
-/**
- * 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 || {}).linkTask, linkTask = _a === void 0 ? function () { return null; } : _a;
-    var parameterNameToTaskName = function (parameterName) {
-        var parameter = pipelineJson.parameters.find(function (parameter) { return parameter.name === parameterName; });
-        if (!parameter) {
-            throw new UnexpectedError("Could not find {".concat(parameterName, "}"));
-            // <- TODO: !!!!!! This causes problems when {knowledge} and other reserved parameters are used
-        }
-        if (parameter.isInput) {
-            return 'input';
-        }
-        var task = pipelineJson.tasks.find(function (task) { return task.resultingParameterName === parameterName; });
-        if (!task) {
-            throw new Error("Could not find task for {".concat(parameterName, "}"));
-        }
-        return task.name || normalizeTo_camelCase('task-' + titleToName(task.title));
-    };
-    var promptbookMermaid = spaceTrim$1(function (block) { return "\n\n            %% \uD83D\uDD2E Tip: Open this on GitHub or in the VSCode website to see the Mermaid graph visually\n\n            flowchart LR\n              subgraph \"".concat(pipelineJson.title, "\"\n\n                  direction TB\n\n                  input((Input)):::input\n                  ").concat(block(pipelineJson.tasks
-        .flatMap(function (_a) {
-        var title = _a.title, dependentParameterNames = _a.dependentParameterNames, resultingParameterName = _a.resultingParameterName;
-        return __spreadArray([
-            "".concat(parameterNameToTaskName(resultingParameterName), "(\"").concat(title, "\")")
-        ], __read(dependentParameterNames.map(function (dependentParameterName) {
-            return "".concat(parameterNameToTaskName(dependentParameterName), "--\"{").concat(dependentParameterName, "}\"-->").concat(parameterNameToTaskName(resultingParameterName));
-        })), false);
-    })
-        .join('\n')), "\n\n                  ").concat(block(pipelineJson.parameters
-        .filter(function (_a) {
-        var isOutput = _a.isOutput;
-        return isOutput;
-    })
-        .map(function (_a) {
-        var name = _a.name;
-        return "".concat(parameterNameToTaskName(name), "--\"{").concat(name, "}\"-->output");
-    })
-        .join('\n')), "\n                  output((Output)):::output\n\n                  ").concat(block(pipelineJson.tasks
-        .map(function (task) {
-        var link = linkTask(task);
-        if (link === null) {
-            return '';
-        }
-        var href = link.href, title = link.title;
-        var taskName = parameterNameToTaskName(task.resultingParameterName);
-        return "click ".concat(taskName, " href \"").concat(href, "\" \"").concat(title, "\";");
-    })
-        .filter(function (line) { return line !== ''; })
-        .join('\n')), "\n\n                  classDef input color: grey;\n                  classDef output color: grey;\n\n              end;\n\n        "); });
-    return promptbookMermaid;
-}
-/**
- * TODO: [🧠] !! FOREACH in mermaid graph
- * TODO: [🧠] !! Knowledge in mermaid graph
- * TODO: [🧠] !! Personas in mermaid graph
- * TODO: Maybe use some Mermaid package instead of string templating
- * TODO: [🕌] When more than 2 functionalities, split into separate functions
- */
-
 /**
  * Prettyfies Promptbook string and adds Mermaid graph
  *
@@ -11728,26 +11948,6 @@ function initializePrettifyCommand(program) {
  * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
  */
 
-/**
- * Format either small or big number
- *
- * @private within the repository
- */
-function formatNumber(value) {
-    if (value === 0) {
-        return '0';
-    }
-    for (var exponent = 0; exponent < 15; exponent++) {
-        var factor = Math.pow(10, exponent);
-        var valueRounded = Math.round(value * factor) / factor;
-        if (Math.abs(value - valueRounded) / value <
-            0.001 /* <- TODO: Pass as option, pass to executionReportJsonToString as option */) {
-            return valueRounded.toFixed(exponent);
-        }
-    }
-    return value.toString();
-}
-
 /**
  * Create a markdown table from a 2D array of strings
  *
@@ -11807,7 +12007,7 @@ function createMarkdownChart(options) {
         }
         finally { if (e_1) throw e_1.error; }
     }
-    var legend = "_Note: Each \u2588 represents ".concat(formatNumber(1 / scale), " ").concat(unitName, ", width of ").concat(valueHeader.toLowerCase(), " is ").concat(formatNumber(to - from), " ").concat(unitName, " = ").concat(width, " squares_");
+    var legend = "_Note: Each \u2588 represents ".concat(numberToString(1 / scale), " ").concat(unitName, ", width of ").concat(valueHeader.toLowerCase(), " is ").concat(numberToString(to - from), " ").concat(unitName, " = ").concat(width, " squares_");
     return createMarkdownTable(table) + '\n\n' + legend;
 }
 /**
@@ -11936,7 +12136,7 @@ function executionReportJsonToString(executionReportJson, options) {
         headerList.push("COMPLETED AT ".concat(moment(completedAt).format("YYYY-MM-DD HH:mm:ss")));
         headerList.push("TOTAL DURATION ".concat(duration.humanize(MOMENT_ARG_THRESHOLDS)));
         headerList.push("TOTAL LLM DURATION ".concat(llmDuration.humanize(MOMENT_ARG_THRESHOLDS)));
-        headerList.push("TOTAL COST $".concat(formatNumber(cost * (1 + taxRate))) +
+        headerList.push("TOTAL COST $".concat(numberToString(cost * (1 + taxRate))) +
             (executionsWithKnownCost.length === executionReportJson.promptExecutions.length
                 ? ''
                 : " *(Some cost is unknown)*") +
@@ -11994,7 +12194,7 @@ function executionReportJsonToString(executionReportJson, options) {
         // > taskList.push(`STARTED AT ${moment(startedAt).calendar()}`);
         taskList.push("DURATION ".concat(duration.humanize(MOMENT_ARG_THRESHOLDS)));
         if (typeof ((_g = (_f = promptExecution.result) === null || _f === void 0 ? void 0 : _f.usage) === null || _g === void 0 ? void 0 : _g.price) === 'number') {
-            taskList.push("COST $".concat(formatNumber(promptExecution.result.usage.price * (1 + taxRate))) +
+            taskList.push("COST $".concat(numberToString(promptExecution.result.usage.price * (1 + taxRate))) +
                 (taxRate !== 0 ? " *(with tax ".concat(taxRate * 100, "%)*") : ''));
         }
         else {
@@ -12055,6 +12255,148 @@ function executionReportJsonToString(executionReportJson, options) {
  * TODO: [🧠] Should be in generated file GENERATOR_WARNING
  */
 
+/**
+ * @see ./wizzard.ts `getPipeline` method
+ *
+ * @private usable through `ptbk run` and `@prompbook/wizzard`
+ */
+function $getCompiledBook(tools, pipelineSource, options) {
+    return __awaiter(this, void 0, void 0, function () {
+        var fs, fetch, filePathRaw, filePath, filePathCandidates, filePathCandidates_1, filePathCandidates_1_1, filePathCandidate, pipelineString, pipelineJson, e_1_1, rootDirname, _loop_1, i, state_1, response_1, pipelineString, pipelineJson;
+        var e_1, _a;
+        var _this = this;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    fs = tools.fs, fetch = tools.fetch;
+                    if (!isValidFilePath(pipelineSource)) return [3 /*break*/, 10];
+                    filePathRaw = pipelineSource;
+                    filePath = null;
+                    filePathCandidates = [filePathRaw, "".concat(filePathRaw, ".md"), "".concat(filePathRaw, ".book.md"), "".concat(filePathRaw, ".book.md")];
+                    filePathCandidates = __spreadArray(__spreadArray([], __read(filePathCandidates), false), __read(filePathCandidates.map(function (path) { return path.split('\\').join('/'); })), false);
+                    _b.label = 1;
+                case 1:
+                    _b.trys.push([1, 8, 9, 10]);
+                    filePathCandidates_1 = __values(filePathCandidates), filePathCandidates_1_1 = filePathCandidates_1.next();
+                    _b.label = 2;
+                case 2:
+                    if (!!filePathCandidates_1_1.done) return [3 /*break*/, 7];
+                    filePathCandidate = filePathCandidates_1_1.value;
+                    return [4 /*yield*/, isFileExisting(filePathCandidate, fs)
+                        // <- TODO: Also test that among the candidates the file is book not just any file
+                    ];
+                case 3:
+                    if (!_b.sent()) return [3 /*break*/, 6];
+                    filePath = filePathCandidate;
+                    return [4 /*yield*/, fs.readFile(filePath, 'utf-8')];
+                case 4:
+                    pipelineString = (_b.sent());
+                    return [4 /*yield*/, compilePipeline(pipelineString, tools, __assign({ rootDirname: process.cwd() }, options))];
+                case 5:
+                    pipelineJson = _b.sent();
+                    return [2 /*return*/, pipelineJson];
+                case 6:
+                    filePathCandidates_1_1 = filePathCandidates_1.next();
+                    return [3 /*break*/, 2];
+                case 7: return [3 /*break*/, 10];
+                case 8:
+                    e_1_1 = _b.sent();
+                    e_1 = { error: e_1_1 };
+                    return [3 /*break*/, 10];
+                case 9:
+                    try {
+                        if (filePathCandidates_1_1 && !filePathCandidates_1_1.done && (_a = filePathCandidates_1.return)) _a.call(filePathCandidates_1);
+                    }
+                    finally { if (e_1) throw e_1.error; }
+                    return [7 /*endfinally*/];
+                case 10:
+                    if (!isValidPipelineUrl(pipelineSource)) return [3 /*break*/, 14];
+                    rootDirname = process.cwd();
+                    _loop_1 = function (i) {
+                        var collection, pipeline;
+                        return __generator(this, function (_c) {
+                            switch (_c.label) {
+                                case 0: return [4 /*yield*/, createCollectionFromDirectory('./books', tools, __assign({ isRecursive: true, rootDirname: rootDirname }, options))];
+                                case 1:
+                                    collection = _c.sent();
+                                    return [4 /*yield*/, (function () { return __awaiter(_this, void 0, void 0, function () {
+                                            var error_1;
+                                            return __generator(this, function (_a) {
+                                                switch (_a.label) {
+                                                    case 0:
+                                                        _a.trys.push([0, 2, , 3]);
+                                                        return [4 /*yield*/, collection.getPipelineByUrl(pipelineSource)];
+                                                    case 1: return [2 /*return*/, _a.sent()];
+                                                    case 2:
+                                                        error_1 = _a.sent();
+                                                        if (!(error_1 instanceof NotFoundError)) {
+                                                            throw error_1;
+                                                        }
+                                                        // Note: If the pipeline was not found in the collection, try next strategy
+                                                        return [2 /*return*/, null];
+                                                    case 3: return [2 /*return*/];
+                                                }
+                                            });
+                                        }); })()];
+                                case 2:
+                                    pipeline = _c.sent();
+                                    if (pipeline !== null) {
+                                        return [2 /*return*/, { value: pipeline }];
+                                    }
+                                    // Note: searches recursivelly for books
+                                    if (isPathRoot(rootDirname)) {
+                                        return [2 /*return*/, "break"];
+                                    }
+                                    rootDirname = join(rootDirname, '..');
+                                    return [2 /*return*/];
+                            }
+                        });
+                    };
+                    i = 0;
+                    _b.label = 11;
+                case 11:
+                    if (!(i < LOOP_LIMIT)) return [3 /*break*/, 14];
+                    return [5 /*yield**/, _loop_1(i)];
+                case 12:
+                    state_1 = _b.sent();
+                    if (typeof state_1 === "object")
+                        return [2 /*return*/, state_1.value];
+                    if (state_1 === "break")
+                        return [3 /*break*/, 14];
+                    _b.label = 13;
+                case 13:
+                    i++;
+                    return [3 /*break*/, 11];
+                case 14:
+                    if (!isValidPipelineUrl(pipelineSource)) return [3 /*break*/, 18];
+                    return [4 /*yield*/, fetch(pipelineSource)];
+                case 15:
+                    response_1 = _b.sent();
+                    if (response_1.status >= 300) {
+                        throw new NotFoundError(spaceTrim(function (block) { return "\n                        No book found on URL:\n                        ".concat(block(pipelineSource), "\n\n                        Request failed with status ").concat(block(response_1.status.toString()), " ").concat(block(response_1.statusText), "\n                    "); }));
+                    }
+                    return [4 /*yield*/, response_1.text()];
+                case 16:
+                    pipelineString = _b.sent();
+                    return [4 /*yield*/, compilePipeline(pipelineString /* <- TODO: !!!!!! Remove */, tools, __assign({ rootDirname: null }, options))];
+                case 17:
+                    pipelineJson = _b.sent();
+                    return [2 /*return*/, pipelineJson];
+                case 18:
+                    // Strategy 4️⃣: If the pipelineSource is a PipelineString - try to parse it
+                    if (just(false) /* <- TODO: !!!!!! Implement, use and export `isValidPipelineString` */) {
+                        throw new NotYetImplementedError('Strategy 4️⃣: If the pipelineSource is a PipelineString - try to parse it');
+                    } /* not else */
+                    throw new NotFoundError(spaceTrim(function (block) { return "\n                No book found:\n                ".concat(block(pipelineSource), "\n\n                Pipelines can be loaded from:\n                1) As a file ./books/write-cv.book.md\n                2) As a URL https://promptbook.studio/hejny/write-cv.book.md found in ./books folder recursively\n                2) As a URL https://promptbook.studio/hejny/write-cv.book.md fetched from the internet\n                3) As a string\n\n\n            "); }));
+            }
+        });
+    });
+}
+/**
+ * TODO: Write unit test
+ * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ */
+
 /**
  * Run the interactive chatbot in CLI
  *
@@ -12181,20 +12523,20 @@ function initializeRunCommand(program) {
     var runCommand = program.command('run', { isDefault: true });
     runCommand.description(spaceTrim("\n            Runs a pipeline\n      "));
     // TODO: [🧅] DRY command arguments
-    runCommand.argument('<path>', 
+    runCommand.argument('<pipelineSource>', 
     // <- Note: [🧟‍♂️] This is NOT promptbook collection directory BUT direct path to .book.md file
-    'Path to book file');
+    'Path to book file OR URL to book file');
     runCommand.option('-r, --reload', "Call LLM models even if same prompt with result is in the cache", false);
     runCommand.option('-v, --verbose', "Is output verbose", false);
     runCommand.option('--no-interactive', "Input is not interactive, if true you need to pass all the input parameters through --json");
     runCommand.option('--no-formfactor', "When set, behavior of the interactive mode is not changed by the formfactor of the pipeline");
     runCommand.option('-j, --json <json>', "Pass all or some input parameters as JSON record, if used the output is also returned as JSON");
     runCommand.option('-s, --save-report <path>', "Save report to file");
-    runCommand.action(function (filePathRaw, options) { return __awaiter(_this, void 0, void 0, function () {
-        var isCacheReloaded, isInteractive, isFormfactorUsed, json, isVerbose, saveReport, inputParameters, prepareAndScrapeOptions, fs, filePath, filePathCandidates, filePathCandidates_1, filePathCandidates_1_1, filePathCandidate, e_1_1, llm, executables, tools, pipelineString, pipeline, error_1, pipelineExecutor, questions, response, result, isSuccessful, errors, warnings, outputParameters, executionReport, executionReportString, _a, _b, error, _c, _d, warning, _e, _f, key, value, separator;
-        var e_1, _g, _h, e_2, _j, e_3, _k, e_4, _l;
-        return __generator(this, function (_m) {
-            switch (_m.label) {
+    runCommand.action(function (pipelineSource, options) { return __awaiter(_this, void 0, void 0, function () {
+        var isCacheReloaded, isInteractive, isFormfactorUsed, json, isVerbose, saveReport, inputParameters, prepareAndScrapeOptions, fs, llm, executables, tools, pipeline, error_1, pipelineExecutor, questions, response, result, isSuccessful, errors, warnings, outputParameters, executionReport, executionReportString, _a, _b, error, _c, _d, warning, _e, _f, key, value, separator;
+        var _g, e_1, _h, e_2, _j, e_3, _k;
+        return __generator(this, function (_l) {
+            switch (_l.label) {
                 case 0:
                     isCacheReloaded = options.reload, isInteractive = options.interactive, isFormfactorUsed = options.formfactor, json = options.json, isVerbose = options.verbose, saveReport = options.saveReport;
                     if (saveReport && !saveReport.endsWith('.json') && !saveReport.endsWith('.md')) {
@@ -12214,49 +12556,8 @@ function initializeRunCommand(program) {
                         console.info(colors.gray('--- Preparing tools ---'));
                     }
                     fs = $provideFilesystemForNode(prepareAndScrapeOptions);
-                    filePath = null;
-                    filePathCandidates = [filePathRaw, "".concat(filePathRaw, ".md"), "".concat(filePathRaw, ".book.md"), "".concat(filePathRaw, ".book.md")];
-                    filePathCandidates = __spreadArray(__spreadArray([], __read(filePathCandidates), false), __read(filePathCandidates.map(function (path) { return path.split('\\').join('/'); })), false);
-                    _m.label = 1;
-                case 1:
-                    _m.trys.push([1, 6, 7, 8]);
-                    filePathCandidates_1 = __values(filePathCandidates), filePathCandidates_1_1 = filePathCandidates_1.next();
-                    _m.label = 2;
-                case 2:
-                    if (!!filePathCandidates_1_1.done) return [3 /*break*/, 5];
-                    filePathCandidate = filePathCandidates_1_1.value;
-                    return [4 /*yield*/, isFileExisting(filePathCandidate, fs)
-                        // <- TODO: Also test that among the candidates the file is book not just any file
-                    ];
-                case 3:
-                    if (_m.sent()
-                    // <- TODO: Also test that among the candidates the file is book not just any file
-                    ) {
-                        filePath = filePathCandidate;
-                        return [3 /*break*/, 5];
-                    }
-                    _m.label = 4;
-                case 4:
-                    filePathCandidates_1_1 = filePathCandidates_1.next();
-                    return [3 /*break*/, 2];
-                case 5: return [3 /*break*/, 8];
-                case 6:
-                    e_1_1 = _m.sent();
-                    e_1 = { error: e_1_1 };
-                    return [3 /*break*/, 8];
-                case 7:
-                    try {
-                        if (filePathCandidates_1_1 && !filePathCandidates_1_1.done && (_g = filePathCandidates_1.return)) _g.call(filePathCandidates_1);
-                    }
-                    finally { if (e_1) throw e_1.error; }
-                    return [7 /*endfinally*/];
-                case 8:
-                    if (filePath === null) {
-                        console.error(colors.red("File \"".concat(filePathRaw, "\" does not exist")));
-                        return [2 /*return*/, process.exit(1)];
-                    }
                     try {
-                        llm = $provideLlmToolsForCli(prepareAndScrapeOptions);
+                        llm = $provideLlmToolsForWizzardOrCli(prepareAndScrapeOptions);
                     }
                     catch (error) {
                         if (!(error instanceof Error)) {
@@ -12275,43 +12576,41 @@ function initializeRunCommand(program) {
                         return [2 /*return*/, process.exit(1)];
                     }
                     return [4 /*yield*/, $provideExecutablesForNode(prepareAndScrapeOptions)];
-                case 9:
-                    executables = _m.sent();
-                    _h = {
+                case 1:
+                    executables = _l.sent();
+                    _g = {
                         llm: llm,
-                        fs: fs
+                        fs: fs,
+                        fetch: scraperFetch
                     };
                     return [4 /*yield*/, $provideScrapersForNode({ fs: fs, llm: llm, executables: executables }, prepareAndScrapeOptions)];
-                case 10:
-                    tools = (_h.scrapers = _m.sent(),
-                        _h.script = [
+                case 2:
+                    tools = (_g.scrapers = _l.sent(),
+                        _g.script = [
                         /*new JavascriptExecutionTools(options)*/
                         ],
-                        _h);
+                        _g);
                     if (isVerbose) {
                         console.info(colors.gray('--- Reading file ---'));
                     }
-                    return [4 /*yield*/, readFile(filePath, 'utf-8')];
-                case 11:
-                    pipelineString = (_m.sent());
                     if (isVerbose) {
                         console.info(colors.gray('--- Preparing pipeline ---'));
                     }
-                    _m.label = 12;
-                case 12:
-                    _m.trys.push([12, 14, , 15]);
-                    return [4 /*yield*/, compilePipeline(pipelineString, tools)];
-                case 13:
-                    pipeline = _m.sent();
-                    return [3 /*break*/, 15];
-                case 14:
-                    error_1 = _m.sent();
+                    _l.label = 3;
+                case 3:
+                    _l.trys.push([3, 5, , 6]);
+                    return [4 /*yield*/, $getCompiledBook(tools, pipelineSource, prepareAndScrapeOptions)];
+                case 4:
+                    pipeline = _l.sent();
+                    return [3 /*break*/, 6];
+                case 5:
+                    error_1 = _l.sent();
                     if (!(error_1 instanceof ParseError)) {
                         throw error_1;
                     }
-                    console.error(colors.red(spaceTrim(function (block) { return "\n                            ".concat(block(error_1.message), "\n\n                            in ").concat(filePath, "\n                        "); })));
+                    console.error(colors.red(spaceTrim(function (block) { return "\n                            ".concat(block(error_1.message), "\n\n                            in ").concat(pipelineSource, "\n                        "); })));
                     return [2 /*return*/, process.exit(1)];
-                case 15:
+                case 6:
                     if (isVerbose) {
                         console.info(colors.gray('--- Validating pipeline ---'));
                     }
@@ -12397,8 +12696,8 @@ function initializeRunCommand(program) {
                         return [2 /*return*/, process.exit(1)];
                     }
                     return [4 /*yield*/, prompts(questions)];
-                case 16:
-                    response = _m.sent();
+                case 7:
+                    response = _l.sent();
                     //                     <- TODO: [🧠][🍼] Change behavior according to the formfactor
                     inputParameters = __assign(__assign({}, inputParameters), response);
                     // TODO: Maybe do some validation of the response (and --json argument which is passed)
@@ -12411,26 +12710,26 @@ function initializeRunCommand(program) {
                                 console.info(taskProgress);
                             }
                         })];
-                case 17:
-                    result = _m.sent();
+                case 8:
+                    result = _l.sent();
                     isSuccessful = result.isSuccessful, errors = result.errors, warnings = result.warnings, outputParameters = result.outputParameters, executionReport = result.executionReport;
                     if (isVerbose) {
                         console.info(colors.gray('--- Detailed Result ---'));
                         console.info({ isSuccessful: isSuccessful, errors: errors, warnings: warnings, outputParameters: outputParameters, executionReport: executionReport });
                     }
-                    if (!(saveReport && saveReport.endsWith('.json'))) return [3 /*break*/, 19];
+                    if (!(saveReport && saveReport.endsWith('.json'))) return [3 /*break*/, 10];
                     return [4 /*yield*/, writeFile(saveReport, JSON.stringify(executionReport, null, 4) + '\n', 'utf-8')];
-                case 18:
-                    _m.sent();
-                    return [3 /*break*/, 21];
-                case 19:
-                    if (!(saveReport && saveReport.endsWith('.md'))) return [3 /*break*/, 21];
+                case 9:
+                    _l.sent();
+                    return [3 /*break*/, 12];
+                case 10:
+                    if (!(saveReport && saveReport.endsWith('.md'))) return [3 /*break*/, 12];
                     executionReportString = executionReportJsonToString(executionReport);
                     return [4 /*yield*/, writeFile(saveReport, executionReportString, 'utf-8')];
-                case 20:
-                    _m.sent();
-                    _m.label = 21;
-                case 21:
+                case 11:
+                    _l.sent();
+                    _l.label = 12;
+                case 12:
                     if (saveReport && isVerbose) {
                         console.info(colors.green("Report saved to ".concat(saveReport)));
                     }
@@ -12448,12 +12747,12 @@ function initializeRunCommand(program) {
                             console.error(colors.red(colors.bold(error.name) + ': ' + error.message));
                         }
                     }
-                    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                    catch (e_1_1) { e_1 = { error: e_1_1 }; }
                     finally {
                         try {
-                            if (_b && !_b.done && (_j = _a.return)) _j.call(_a);
+                            if (_b && !_b.done && (_h = _a.return)) _h.call(_a);
                         }
-                        finally { if (e_2) throw e_2.error; }
+                        finally { if (e_1) throw e_1.error; }
                     }
                     try {
                         for (_c = __values(warnings || []), _d = _c.next(); !_d.done; _d = _c.next()) {
@@ -12461,12 +12760,12 @@ function initializeRunCommand(program) {
                             console.error(colors.red(colors.bold(warning.name) + ': ' + warning.message));
                         }
                     }
-                    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                    catch (e_2_1) { e_2 = { error: e_2_1 }; }
                     finally {
                         try {
-                            if (_d && !_d.done && (_k = _c.return)) _k.call(_c);
+                            if (_d && !_d.done && (_j = _c.return)) _j.call(_c);
                         }
-                        finally { if (e_3) throw e_3.error; }
+                        finally { if (e_2) throw e_2.error; }
                     }
                     if (json === undefined) {
                         try {
@@ -12477,12 +12776,12 @@ function initializeRunCommand(program) {
                                 console.info(colors.green(colors.bold(key) + separator + value));
                             }
                         }
-                        catch (e_4_1) { e_4 = { error: e_4_1 }; }
+                        catch (e_3_1) { e_3 = { error: e_3_1 }; }
                         finally {
                             try {
-                                if (_f && !_f.done && (_l = _e.return)) _l.call(_e);
+                                if (_f && !_f.done && (_k = _e.return)) _k.call(_e);
                             }
-                            finally { if (e_4) throw e_4.error; }
+                            finally { if (e_3) throw e_3.error; }
                         }
                     }
                     else {
@@ -12530,7 +12829,7 @@ function initializeTestCommand(program) {
                             isCacheReloaded: isCacheReloaded,
                         };
                         fs = $provideFilesystemForNode(prepareAndScrapeOptions);
-                        llm = $provideLlmToolsForCli(prepareAndScrapeOptions);
+                        llm = $provideLlmToolsForWizzardOrCli(prepareAndScrapeOptions);
                         return [4 /*yield*/, $provideExecutablesForNode(prepareAndScrapeOptions)];
                     case 1:
                         executables = _f.sent();
@@ -12691,6 +12990,7 @@ var _CLI = {
  * 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 _AnthropicClaudeMetadataRegistration = $llmToolsMetadataRegister.register({
@@ -13186,7 +13486,7 @@ var AnthropicClaudeExecutionTools = /** @class */ (function () {
                             throw new PipelineExecutionError('Use callChatModel only for CHAT variant');
                         }
                         modelName = modelRequirements.modelName || this.getDefaultChatModel().modelName;
-                        rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                        rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
                         rawRequest = {
                             model: modelRequirements.modelName || this.getDefaultChatModel().modelName,
                             max_tokens: modelRequirements.maxTokens || 4096,
@@ -13405,7 +13705,9 @@ var createAnthropicClaudeExecutionTools = Object.assign(function (options) {
  * 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/anthropic-claude`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
+ *
  */
 var _AnthropicClaudeRegistration = $llmToolsRegister.register(createAnthropicClaudeExecutionTools);
 /**
@@ -13419,6 +13721,7 @@ var _AnthropicClaudeRegistration = $llmToolsRegister.register(createAnthropicCla
  * 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 _AzureOpenAiMetadataRegistration = $llmToolsMetadataRegister.register({
@@ -13992,7 +14295,7 @@ var AzureOpenAiExecutionTools = /** @class */ (function () {
                             // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
                             // <- Note: [🧆]
                         };
-                        rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                        rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
                         messages = __spreadArray(__spreadArray([], __read((modelRequirements.systemMessage === undefined
                             ? []
                             : [
@@ -14107,7 +14410,7 @@ var AzureOpenAiExecutionTools = /** @class */ (function () {
                             console.info(colors.bgWhite('content'), JSON.stringify(content, null, 4));
                             console.info(colors.bgWhite('parameters'), JSON.stringify(parameters, null, 4));
                         }
-                        rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                        rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
                         rawRequest = [
                             modelName,
                             [rawPromptContent],
@@ -14226,6 +14529,7 @@ var createAzureOpenAiExecutionTools = Object.assign(function (options) {
  * 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/azure-openai`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _AzureOpenAiRegistration = $llmToolsRegister.register(createAzureOpenAiExecutionTools);
@@ -14234,21 +14538,13 @@ var _AzureOpenAiRegistration = $llmToolsRegister.register(createAzureOpenAiExecu
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
-/**
- * Detects if the code is running in jest environment
- *
- * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
- *
- * @public exported from `@promptbook/utils`
- */
-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 _GoogleMetadataRegistration = $llmToolsMetadataRegister.register({
@@ -14298,6 +14594,10 @@ var _GoogleMetadataRegistration = $llmToolsMetadataRegister.register({
  * For example:
  * - `Date` objects will be converted to string
  *
+ * Note: There are 2 similar functions
+ * - `valueToString` converts value to string for LLM models as human-readable string
+ * - `asSerializable` converts value to string to preserve full information to be able to convert it back
+ *
  * @private Internal helper function
  */
 function asSerializable(value) {
@@ -14375,7 +14675,7 @@ function createExecutionToolsFromVercelProvider(options) {
                             return [4 /*yield*/, vercelProvider.chat(modelName, __assign({ user: (userId === null || userId === void 0 ? void 0 : userId.toString()) || undefined }, additionalChatSettings))];
                         case 1:
                             model = _b.sent();
-                            rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                            rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
                             rawRequest = {
                                 // <- TODO: [☂]
                                 inputFormat: 'messages',
@@ -14503,6 +14803,7 @@ var createGoogleExecutionTools = Object.assign(function (options) {
  * 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/google`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _GoogleRegistration = $llmToolsRegister.register(createGoogleExecutionTools);
@@ -14517,6 +14818,7 @@ var _GoogleRegistration = $llmToolsRegister.register(createGoogleExecutionTools)
  * 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 _OpenAiMetadataRegistration = $llmToolsMetadataRegister.register({
@@ -14555,6 +14857,7 @@ var _OpenAiMetadataRegistration = $llmToolsMetadataRegister.register({
  * Note: [🏐] Configurations registrations are done in @@@ BUT constructor @@@
  *
  * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _OpenAiAssistantMetadataRegistration = $llmToolsMetadataRegister.register({
@@ -14597,24 +14900,6 @@ var _OpenAiAssistantMetadataRegistration = $llmToolsMetadataRegister.register({
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
-/**
- * Detects if the code is running in a browser environment in main thread (Not in a web worker)
- *
- * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
- *
- * @public exported from `@promptbook/utils`
- */
-var $isRunningInBrowser = new Function("\n    try {\n        return this === window;\n    } catch (e) {\n        return false;\n    }\n");
-
-/**
- * Detects if the code is running in a web worker
- *
- * Note: `$` is used to indicate that this function is not a pure function - it looks at the global object to determine the environment
- *
- * @public exported from `@promptbook/utils`
- */
-var $isRunningInWebWorker = new Function("\n    try {\n        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {\n            return true;\n        } else {\n            return false;\n        }\n    } catch (e) {\n        return false;\n    }\n");
-
 /**
  * Computes the usage of the OpenAI API based on the response from OpenAI
  *
@@ -14772,7 +15057,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                                 type: 'json_object',
                             };
                         }
-                        rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                        rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
                         rawRequest = __assign(__assign({}, modelSettings), { messages: __spreadArray(__spreadArray([], __read((modelRequirements.systemMessage === undefined
                                 ? []
                                 : [
@@ -14868,7 +15153,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                             // <- TODO: [🈁] Use `seed` here AND/OR use is `isDeterministic` for entire execution tools
                             // <- Note: [🧆]
                         };
-                        rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                        rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
                         rawRequest = __assign(__assign({}, modelSettings), { prompt: rawPromptContent, user: (_a = this.options.userId) === null || _a === void 0 ? void 0 : _a.toString() });
                         start = $getCurrentDate();
                         if (this.options.isVerbose) {
@@ -14940,7 +15225,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
                             throw new PipelineExecutionError('Use embed only for EMBEDDING variant');
                         }
                         modelName = modelRequirements.modelName || this.getDefaultEmbeddingModel().modelName;
-                        rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
+                        rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: modelName }));
                         rawRequest = {
                             input: rawPromptContent,
                             model: modelName,
@@ -15110,7 +15395,7 @@ var OpenAiAssistantExecutionTools = /** @class */ (function (_super) {
                             }
                             finally { if (e_1) throw e_1.error; }
                         }
-                        rawPromptContent = replaceParameters(content, __assign(__assign({}, parameters), { modelName: 'assistant' }));
+                        rawPromptContent = templateParameters(content, __assign(__assign({}, parameters), { modelName: 'assistant' }));
                         rawRequest = {
                             // TODO: [👨‍👨‍👧‍👧] ...modelSettings,
                             // TODO: [👨‍👨‍👧‍👧][🧠] What about system message for assistants, does it make sence - combination of OpenAI assistants with Promptbook Personas
@@ -15260,6 +15545,7 @@ var createOpenAiExecutionTools = Object.assign(function (options) {
  * 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/openai`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _OpenAiRegistration = $llmToolsRegister.register(createOpenAiExecutionTools);
@@ -15269,6 +15555,7 @@ var _OpenAiRegistration = $llmToolsRegister.register(createOpenAiExecutionTools)
  * Note: [🏐] Configurations registrations are done in @@@ BUT constructor @@@
  *
  * @public exported from `@promptbook/openai`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _OpenAiAssistantRegistration = $llmToolsRegister.register(createOpenAiAssistantExecutionTools);
@@ -15530,6 +15817,7 @@ var markdownScraperMetadata = $deepFreeze({
  * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available known scrapers
  *
  * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _MarkdownScraperMetadataRegistration = $scrapersMetadataRegister.register(markdownScraperMetadata);
@@ -15727,6 +16015,7 @@ var documentScraperMetadata = $deepFreeze({
  * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available known scrapers
  *
  * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _DocumentScraperMetadataRegistration = $scrapersMetadataRegister.register(documentScraperMetadata);
@@ -15894,6 +16183,7 @@ var legacyDocumentScraperMetadata = $deepFreeze({
  * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available known scrapers
  *
  * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _LegacyDocumentScraperMetadataRegistration = $scrapersMetadataRegister.register(legacyDocumentScraperMetadata);
@@ -16064,6 +16354,7 @@ var createLegacyDocumentScraper = Object.assign(function (tools, options) {
  * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available known scrapers
  *
  * @public exported from `@promptbook/legacy-documents`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _LegacyDocumentScraperRegistration = $scrapersRegister.register(createLegacyDocumentScraper);
@@ -16090,6 +16381,7 @@ var createDocumentScraper = Object.assign(function (tools, options) {
  * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available known scrapers
  *
  * @public exported from `@promptbook/documents`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _DocumentScraperRegistration = $scrapersRegister.register(createDocumentScraper);
@@ -16116,6 +16408,7 @@ var createMarkdownScraper = Object.assign(function (tools, options) {
  * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available known scrapers
  *
  * @public exported from `@promptbook/markdown-utils`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _MarkdownScraperRegistration = $scrapersRegister.register(createMarkdownScraper);
@@ -16144,6 +16437,7 @@ var pdfScraperMetadata = $deepFreeze({
  * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available known scrapers
  *
  * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _PdfScraperMetadataRegistration = $scrapersMetadataRegister.register(pdfScraperMetadata);
@@ -16228,6 +16522,7 @@ var createPdfScraper = Object.assign(function (tools, options) {
  * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available known scrapers
  *
  * @public exported from `@promptbook/pdf`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _PdfScraperRegistration = $scrapersRegister.register(createPdfScraper);
@@ -16256,6 +16551,7 @@ var websiteScraperMetadata = $deepFreeze({
  * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available known scrapers
  *
  * @public exported from `@promptbook/core`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _WebsiteScraperMetadataRegistration = $scrapersMetadataRegister.register(websiteScraperMetadata);
@@ -16429,6 +16725,7 @@ var createWebsiteScraper = Object.assign(function (tools, options) {
  * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available known scrapers
  *
  * @public exported from `@promptbook/website-crawler`
+ * @public exported from `@promptbook/wizzard`
  * @public exported from `@promptbook/cli`
  */
 var _WebsiteScraperRegistration = $scrapersRegister.register(createWebsiteScraper);