@promptbook/core 0.60.0-4 → 0.60.0-5

package/esm/index.es.js

@@ -122,6 +122,28 @@ function __spreadArray(to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 }
 
+/**
+ * Converts PipelineCollection to serialized JSON
+ *
+ * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
+ */
+function collectionToJson(collection) {
+    return __awaiter(this, void 0, void 0, function () {
+        var pipelineUrls, promptbooks;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, collection.listPipelines()];
+                case 1:
+                    pipelineUrls = _a.sent();
+                    return [4 /*yield*/, Promise.all(pipelineUrls.map(function (url) { return collection.getPipelineByUrl(url); }))];
+                case 2:
+                    promptbooks = _a.sent();
+                    return [2 /*return*/, promptbooks];
+            }
+        });
+    });
+}
+
 /**
  * Prettify the html code
  *
@@ -170,7 +192,7 @@ function capitalize(word) {
  */
 function pipelineJsonToString(pipelineJson) {
     var e_1, _a, e_2, _b, e_3, _c, e_4, _d, e_5, _e, e_6, _f;
-    var title = pipelineJson.title, promptbookUrl = pipelineJson.promptbookUrl, promptbookVersion = pipelineJson.promptbookVersion, description = pipelineJson.description, parameters = pipelineJson.parameters, promptTemplates = pipelineJson.promptTemplates;
+    var title = pipelineJson.title, pipelineUrl = pipelineJson.pipelineUrl, promptbookVersion = pipelineJson.promptbookVersion, description = pipelineJson.description, parameters = pipelineJson.parameters, promptTemplates = pipelineJson.promptTemplates;
     var pipelineString = "# ".concat(title);
     if (description) {
         pipelineString += '\n\n';
@@ -178,8 +200,8 @@ function pipelineJsonToString(pipelineJson) {
     }
     // TODO:> const commands: Array<Command>
     var commands = [];
-    if (promptbookUrl) {
-        commands.push("PROMPTBOOK URL ".concat(promptbookUrl));
+    if (pipelineUrl) {
+        commands.push("PIPELINE URL ".concat(pipelineUrl));
     }
     commands.push("PROMPTBOOK VERSION ".concat(promptbookVersion));
     pipelineString = prettifyMarkdown(pipelineString);
@@ -361,47 +383,6 @@ function promptTemplateParameterJsonToString(promptTemplateParameterJson) {
  * TODO: Escape all
  */
 
-var PipelineCollection = [{title:"Prepare Keywords",promptbookUrl:"https://promptbook.studio/promptbook/prepare-keywords.ptbk.md",promptbookVersion:"0.60.0-3",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{name:"knowledge",title:"Knowledge",dependentParameterNames:["content"],executionType:"PROMPT_TEMPLATE",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},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> {content}",resultingParameterName:"keywords"}],knowledge:[]},{title:"Prepare Knowledge from Markdown",promptbookUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.60.0-3",parameters:[{name:"content",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledge",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{name:"knowledge",title:"Knowledge",dependentParameterNames:["content"],executionType:"PROMPT_TEMPLATE",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},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> {content}",resultingParameterName:"knowledge"}],knowledge:[]}];
-
-/**
- * This error indicates errors during the execution of the promptbook
- */
-var ExecutionError = /** @class */ (function (_super) {
-    __extends(ExecutionError, _super);
-    function ExecutionError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'ExecutionError';
-        Object.setPrototypeOf(_this, ExecutionError.prototype);
-        return _this;
-    }
-    return ExecutionError;
-}(Error));
-
-/**
- * Asserts that the execution of a promptnook is successful
- *
- * @param executionResult - The partial result of the promptnook execution
- * @throws {ExecutionError} If the execution is not successful or if multiple errors occurred
- */
-function assertsExecutionSuccessful(executionResult) {
-    var isSuccessful = executionResult.isSuccessful, errors = executionResult.errors;
-    if (isSuccessful === true) {
-        return;
-    }
-    if (errors.length === 0) {
-        throw new ExecutionError("Promptnook Execution failed because of unknown reason");
-    }
-    else if (errors.length === 1) {
-        throw errors[0];
-    }
-    else {
-        throw new ExecutionError(spaceTrim$1(function (block) { return "\n                    Multiple errors occurred during promptnook execution\n\n                    ".concat(block(errors.map(function (error) { return '- ' + error.message; }).join('\n')), "\n                "); }));
-    }
-}
-/**
- * TODO: [🧠] Can this return type be better typed than void
- */
-
 /**
  * The maximum number of iterations for a loops
  */
@@ -441,7 +422,7 @@ var SyntaxError = /** @class */ (function (_super) {
 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 promptbook library\n\n                    Please report issue:\n                    https://github.com/webgptorg/promptbook/issues\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
+        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                    https://github.com/webgptorg/promptbook/issues\n\n                    Or contact us on me@pavolhejny.com\n\n                "); })) || this;
         _this.name = 'UnexpectedError';
         Object.setPrototypeOf(_this, UnexpectedError.prototype);
         return _this;
@@ -491,10 +472,10 @@ function isValidUrl(url) {
 function validatePipeline(pipeline) {
     // TODO: [🧠] Maybe test if promptbook is a promise and make specific error case for that
     var e_1, _a, e_2, _b, e_3, _c, e_4, _d;
-    if (pipeline.promptbookUrl !== undefined) {
-        if (!isValidUrl(pipeline.promptbookUrl)) {
+    if (pipeline.pipelineUrl !== undefined) {
+        if (!isValidUrl(pipeline.pipelineUrl)) {
             // TODO: This should be maybe the syntax error detected during parsing
-            throw new PipelineLogicError("Invalid promptbook URL \"".concat(pipeline.promptbookUrl, "\""));
+            throw new PipelineLogicError("Invalid promptbook URL \"".concat(pipeline.pipelineUrl, "\""));
         }
     }
     // TODO: [🧠] Maybe do here some propper JSON-schema / ZOD checking
@@ -660,6 +641,369 @@ function validatePipeline(pipeline) {
  *     >  ex port function validatePipeline(promptbook: unknown): asserts promptbook is PipelineJson {
  */
 
+/**
+ * This error indicates that promptbook not found in the collection
+ */
+var NotFoundError = /** @class */ (function (_super) {
+    __extends(NotFoundError, _super);
+    function NotFoundError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'NotFoundError';
+        Object.setPrototypeOf(_this, NotFoundError.prototype);
+        return _this;
+    }
+    return NotFoundError;
+}(Error));
+
+/**
+ * This error indicates errors in referencing promptbooks between each other
+ */
+var ReferenceError$1 = /** @class */ (function (_super) {
+    __extends(ReferenceError, _super);
+    function ReferenceError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'ReferenceError';
+        Object.setPrototypeOf(_this, ReferenceError.prototype);
+        return _this;
+    }
+    return ReferenceError;
+}(Error));
+
+/**
+ * Library of promptbooks that groups together promptbooks for an application.
+ * This implementation is a very thin wrapper around the Array / Map of promptbooks.
+ *
+ * @private use `createCollectionFromJson` instead
+ * @see https://github.com/webgptorg/promptbook#promptbook-collection
+ */
+var SimplePipelineCollection = /** @class */ (function () {
+    /**
+     * Constructs a pipeline collection from promptbooks
+     *
+     * @param promptbooks !!!
+     *
+     * @private Use instead `createCollectionFromJson`
+     * Note: During the construction logic of all promptbooks are validated
+     * Note: It is not recommended to use this constructor directly, use `createCollectionFromJson` *(or other variant)* instead
+     */
+    function SimplePipelineCollection() {
+        var e_1, _a;
+        var promptbooks = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            promptbooks[_i] = arguments[_i];
+        }
+        this.collection = new Map();
+        try {
+            for (var promptbooks_1 = __values(promptbooks), promptbooks_1_1 = promptbooks_1.next(); !promptbooks_1_1.done; promptbooks_1_1 = promptbooks_1.next()) {
+                var promptbook = promptbooks_1_1.value;
+                if (promptbook.pipelineUrl === undefined) {
+                    throw new ReferenceError$1(spaceTrim$1("\n                        Promptbook with name \"".concat(promptbook.title, "\" does not have defined URL\n\n                        Note: Promptbooks without URLs are called anonymous promptbooks\n                              They can be used as standalone promptbooks, but they cannot be referenced by other promptbooks\n                              And also they cannot be used in the pipeline collection\n\n                    ")));
+                }
+                validatePipeline(promptbook);
+                // Note: [🦄]
+                if (this.collection.has(promptbook.pipelineUrl) &&
+                    pipelineJsonToString(promptbook) !== pipelineJsonToString(this.collection.get(promptbook.pipelineUrl))) {
+                    throw new ReferenceError$1(spaceTrim$1("\n                        Promptbook with URL \"".concat(promptbook.pipelineUrl, "\" is already in the collection\n\n                        Note: Promptbooks with the same URL are not allowed\n                        Note: Automatically check whether the promptbooks are the same BUT they are DIFFERENT\n\n                    ")));
+                }
+                this.collection.set(promptbook.pipelineUrl, promptbook);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (promptbooks_1_1 && !promptbooks_1_1.done && (_a = promptbooks_1.return)) _a.call(promptbooks_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    }
+    /**
+     * Gets all promptbooks in the collection
+     */
+    SimplePipelineCollection.prototype.listPipelines = function () {
+        return Array.from(this.collection.keys());
+    };
+    /**
+     * Gets promptbook by its URL
+     *
+     * Note: This is not a direct fetching from the URL, but a lookup in the collection
+     */
+    SimplePipelineCollection.prototype.getPipelineByUrl = function (url) {
+        var _this = this;
+        var promptbook = this.collection.get(url);
+        if (!promptbook) {
+            if (this.listPipelines().length === 0) {
+                throw new NotFoundError(spaceTrim$1("\n                            Promptbook with url \"".concat(url, "\" not found\n\n                            No promptbooks available\n                        ")));
+            }
+            throw new NotFoundError(spaceTrim$1(function (block) { return "\n                        Promptbook with url \"".concat(url, "\" not found\n\n                        Available promptbooks:\n                        ").concat(block(_this.listPipelines()
+                .map(function (pipelineUrl) { return "- ".concat(pipelineUrl); })
+                .join('\n')), "\n\n                    "); }));
+        }
+        return promptbook;
+    };
+    /**
+     * Checks whether given prompt was defined in any promptbook in the collection
+     */
+    SimplePipelineCollection.prototype.isResponsibleForPrompt = function (prompt) {
+        return true;
+    };
+    return SimplePipelineCollection;
+}());
+
+/**
+ * Creates PipelineCollection from array of PipelineJson or PipelineString
+ *
+ * Note: Functions `collectionToJson` and `createCollectionFromJson` are complementary
+ * Note: During the construction syntax and logic of all sources are validated
+ *
+ * @param promptbookSources
+ * @returns PipelineCollection
+ */
+function createCollectionFromJson() {
+    var promptbooks = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        promptbooks[_i] = arguments[_i];
+    }
+    return new (SimplePipelineCollection.bind.apply(SimplePipelineCollection, __spreadArray([void 0], __read(promptbooks), false)))();
+}
+
+/**
+ * Constructs Promptbook from async sources
+ * It can be one of the following:
+ * - Promise of array of PipelineJson or PipelineString
+ * - Factory function that returns Promise of array of PipelineJson or PipelineString
+ *
+ * Note: This is useful as internal tool for other constructor functions like
+ *       `createCollectionFromUrl` or `createCollectionFromDirectory`
+ *       Consider using those functions instead of this one
+ *
+ * Note: The function does NOT return promise it returns the collection directly which waits for the sources to be resolved
+ *       when error occurs in given promise or factory function, it is thrown during `listPipelines` or `getPipelineByUrl` call
+ *
+ * Note: Consider using  `createCollectionFromDirectory` or `createCollectionFromUrl`
+ *
+ * @param promptbookSourcesPromiseOrFactory
+ * @returns PipelineCollection
+ * @deprecated Do not use, it will became internal tool for other constructor functions
+ */
+function createCollectionFromPromise(promptbookSourcesPromiseOrFactory) {
+    var collection;
+    function forSources() {
+        return __awaiter(this, void 0, void 0, function () {
+            var promptbookSources;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (typeof promptbookSourcesPromiseOrFactory === 'function') {
+                            // Note: Calling factory function only once despite multiple calls to resolveSources
+                            promptbookSourcesPromiseOrFactory = promptbookSourcesPromiseOrFactory();
+                        }
+                        return [4 /*yield*/, promptbookSourcesPromiseOrFactory];
+                    case 1:
+                        promptbookSources = _a.sent();
+                        collection = createCollectionFromJson.apply(void 0, __spreadArray([], __read(promptbookSources), false));
+                        return [2 /*return*/];
+                }
+            });
+        });
+    }
+    function listPipelines() {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, forSources()];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/, /* not await */ collection.listPipelines()];
+                }
+            });
+        });
+    }
+    function getPipelineByUrl(url) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, forSources()];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/, /* not await */ collection.getPipelineByUrl(url)];
+                }
+            });
+        });
+    }
+    function isResponsibleForPrompt(prompt) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, forSources()];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/, /* not await */ collection.isResponsibleForPrompt(prompt)];
+                }
+            });
+        });
+    }
+    return {
+        listPipelines: listPipelines,
+        getPipelineByUrl: getPipelineByUrl,
+        isResponsibleForPrompt: isResponsibleForPrompt,
+    };
+}
+
+/**
+ * Constructs Promptbook from remote Promptbase URL
+
+ * @returns PipelineCollection
+ */
+function createCollectionFromUrl(url, options) {
+    return __awaiter(this, void 0, void 0, function () {
+        var _a, _b, isVerbose, _c, isLazyLoaded, collection;
+        var _this = this;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0:
+                    _a = options || {}, _b = _a.isVerbose, isVerbose = _b === void 0 ? false : _b, _c = _a.isLazyLoaded, isLazyLoaded = _c === void 0 ? false : _c;
+                    collection = createCollectionFromPromise(function () { return __awaiter(_this, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            if (isVerbose) {
+                                console.info("Creating pipeline collection from url ".concat(url.toString()));
+                            }
+                            throw new Error('Not implemented yet');
+                        });
+                    }); });
+                    if (!(isLazyLoaded === false)) return [3 /*break*/, 2];
+                    return [4 /*yield*/, collection.listPipelines()];
+                case 1:
+                    _d.sent();
+                    _d.label = 2;
+                case 2: return [2 /*return*/, collection];
+            }
+        });
+    });
+}
+/**
+ * TODO: !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
+ */
+
+/**
+ * Creates PipelineCollection as a subset of another PipelineCollection
+ *
+ * Note: You can use any type of collection as a parent collection - local, remote, etc.
+ * Note: This is just a thin wrapper / proxy around the parent collection
+ *
+ * @param promptbookSources
+ * @returns PipelineCollection
+ */
+function createSubcollection(collection, predicate) {
+    function listPipelines() {
+        return __awaiter(this, void 0, void 0, function () {
+            var promptbooks;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, collection.listPipelines()];
+                    case 1:
+                        promptbooks = _a.sent();
+                        promptbooks = promptbooks.filter(predicate);
+                        return [2 /*return*/, promptbooks];
+                }
+            });
+        });
+    }
+    function getPipelineByUrl(url) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a, pipeline;
+            var _this = this;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        if (!!predicate(url)) return [3 /*break*/, 2];
+                        _a = NotFoundError.bind;
+                        return [4 /*yield*/, spaceTrim$1(function (block) { return __awaiter(_this, void 0, void 0, function () {
+                                var _a, _b, _c, _d, _e, _f;
+                                return __generator(this, function (_g) {
+                                    switch (_g.label) {
+                                        case 0:
+                                            _c = (_b = "\n                        Promptbook with url \"".concat(url, "\" not found or not accessible\n\n                        Available promptbooks:\n                        ")).concat;
+                                            _d = block;
+                                            return [4 /*yield*/, listPipelines()];
+                                        case 1:
+                                            _e = (_a = _c.apply(_b, [_d.apply(void 0, [(_g.sent()).map(function (pipelineUrl) { return "- ".concat(pipelineUrl); }).join('\n')]), "\n\n                        All available promptbooks in parent collection:\n                        "])).concat;
+                                            _f = block;
+                                            return [4 /*yield*/, collection.listPipelines()];
+                                        case 2: return [2 /*return*/, _e.apply(_a, [_f.apply(void 0, [(_g.sent()).map(function (pipelineUrl) { return "- ".concat(pipelineUrl); }).join('\n')]), "\n\n                    "])];
+                                    }
+                                });
+                            }); })];
+                    case 1: throw new (_a.apply(NotFoundError, [void 0, _b.sent()]))();
+                    case 2: return [4 /*yield*/, collection.getPipelineByUrl(url)];
+                    case 3:
+                        pipeline = _b.sent();
+                        return [2 /*return*/, pipeline];
+                }
+            });
+        });
+    }
+    function isResponsibleForPrompt(prompt) {
+        return __awaiter(this, void 0, void 0, function () {
+            var isResponsible;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, collection.isResponsibleForPrompt(prompt)];
+                    case 1:
+                        isResponsible = _a.sent();
+                        // TODO: !! Only if responsible, check if predicate is true
+                        return [2 /*return*/, isResponsible];
+                }
+            });
+        });
+    }
+    return {
+        listPipelines: listPipelines,
+        getPipelineByUrl: getPipelineByUrl,
+        isResponsibleForPrompt: isResponsibleForPrompt,
+    };
+}
+
+var PipelineCollection = [{title:"Prepare Keywords",pipelineUrl:"https://promptbook.studio/promptbook/prepare-keywords.ptbk.md",promptbookVersion:"0.60.0-4",parameters:[{name:"content",description:"The content",isInput:true,isOutput:false},{name:"keywords",description:"Keywords separated by comma",isInput:false,isOutput:true}],promptTemplates:[{name:"knowledge",title:"Knowledge",dependentParameterNames:["content"],executionType:"PROMPT_TEMPLATE",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},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> {content}",resultingParameterName:"keywords"}],knowledge:[]},{title:"Prepare Knowledge from Markdown",pipelineUrl:"https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md",promptbookVersion:"0.60.0-4",parameters:[{name:"content",description:"Markdown document content",isInput:true,isOutput:false},{name:"knowledge",description:"The knowledge JSON object",isInput:false,isOutput:true}],promptTemplates:[{name:"knowledge",title:"Knowledge",dependentParameterNames:["content"],executionType:"PROMPT_TEMPLATE",modelRequirements:{modelVariant:"CHAT",modelName:"claude-3-opus-20240229"},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> {content}",resultingParameterName:"knowledge"}],knowledge:[]}];
+
+/**
+ * This error indicates errors during the execution of the pipeline
+ */
+var ExecutionError = /** @class */ (function (_super) {
+    __extends(ExecutionError, _super);
+    function ExecutionError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'ExecutionError';
+        Object.setPrototypeOf(_this, ExecutionError.prototype);
+        return _this;
+    }
+    return ExecutionError;
+}(Error));
+
+/**
+ * Asserts that the execution of a promptnook is successful
+ *
+ * @param executionResult - The partial result of the promptnook execution
+ * @throws {ExecutionError} If the execution is not successful or if multiple errors occurred
+ */
+function assertsExecutionSuccessful(executionResult) {
+    var isSuccessful = executionResult.isSuccessful, errors = executionResult.errors;
+    if (isSuccessful === true) {
+        return;
+    }
+    if (errors.length === 0) {
+        throw new ExecutionError("Promptnook Execution failed because of unknown reason");
+    }
+    else if (errors.length === 1) {
+        throw errors[0];
+    }
+    else {
+        throw new ExecutionError(spaceTrim$1(function (block) { return "\n                    Multiple errors occurred during promptnook execution\n\n                    ".concat(block(errors.map(function (error) { return '- ' + error.message; }).join('\n')), "\n                "); }));
+    }
+}
+/**
+ * TODO: [🧠] Can this return type be better typed than void
+ */
+
 /**
  * This error occurs when some expectation is not met in the execution of the pipeline
  *
@@ -699,7 +1043,7 @@ function isValidJsonString(value /* <-[👨‍⚖️] */) {
 /**
  * The version of the Promptbook library
  */
-var PROMPTBOOK_VERSION = '0.60.0-3';
+var PROMPTBOOK_VERSION = '0.60.0-4';
 
 /**
  * Function `addUsage` will add multiple usages into one
@@ -1199,7 +1543,7 @@ var TemplateError = /** @class */ (function (_super) {
  * @returns the template with replaced parameters
  * @throws {TemplateError} if parameter is not defined, not closed, or not opened
  *
- * @private within the createPromptbookExecutor
+ * @private within the createPipelineExecutor
  */
 function replaceParameters(template, parameters) {
     var replacedTemplate = template;
@@ -1252,17 +1596,17 @@ function replaceParameters(template, parameters) {
 }
 
 /**
- * Creates executor function from promptbook and execution tools.
+ * Creates executor function from pipeline and execution tools.
  *
  * @returns The executor function
- * @throws {PipelineLogicError} on logical error in the promptbook
+ * @throws {PipelineLogicError} on logical error in the pipeline
  */
-function createPromptbookExecutor(options) {
+function createPipelineExecutor(options) {
     var _this = this;
-    var promptbook = options.promptbook, tools = options.tools, _a = options.settings, settings = _a === void 0 ? {} : _a;
+    var pipeline = options.pipeline, tools = options.tools, _a = options.settings, settings = _a === void 0 ? {} : _a;
     var _b = settings.maxExecutionAttempts, maxExecutionAttempts = _b === void 0 ? 3 : _b;
-    validatePipeline(promptbook);
-    var promptbookExecutor = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
+    validatePipeline(pipeline);
+    var pipelineExecutor = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
         function executeSingleTemplate(currentTemplate) {
             return __awaiter(this, void 0, void 0, function () {
                 var name, title, priority, prompt, chatThread, completionResult, result, resultString, expectError, scriptExecutionErrors, maxAttempts, jokers, attempt, isJokerAttempt, joker, _a, _b, _c, _d, scriptTools, error_2, e_2_1, _e, _f, functionName, postprocessingError, _g, _h, scriptTools, error_3, e_3_1, e_4_1, error_4;
@@ -1271,9 +1615,9 @@ function createPromptbookExecutor(options) {
                 return __generator(this, function (_o) {
                     switch (_o.label) {
                         case 0:
-                            name = "promptbook-executor-frame-".concat(currentTemplate.name);
+                            name = "pipeline-executor-frame-".concat(currentTemplate.name);
                             title = currentTemplate.title;
-                            priority = promptbook.promptTemplates.length - promptbook.promptTemplates.indexOf(currentTemplate);
+                            priority = pipeline.promptTemplates.length - pipeline.promptTemplates.indexOf(currentTemplate);
                             if (!onProgress /* <- [3] */) return [3 /*break*/, 2]; /* <- [3] */
                             return [4 /*yield*/, onProgress({
                                     name: name,
@@ -1330,9 +1674,9 @@ function createPromptbookExecutor(options) {
                         case 6:
                             prompt = {
                                 title: currentTemplate.title,
-                                promptbookUrl: "".concat(promptbook.promptbookUrl
-                                    ? promptbook.promptbookUrl
-                                    : 'anonymous' /* <- TODO: [🧠] How to deal with anonymous PROMPTBOOKs, do here some auto-url like SHA-256 based ad-hoc identifier? */, "#").concat(currentTemplate.name),
+                                pipelineUrl: "".concat(pipeline.pipelineUrl
+                                    ? pipeline.pipelineUrl
+                                    : 'anonymous' /* <- TODO: [🧠] How to deal with anonymous pipelines, do here some auto-url like SHA-256 based ad-hoc identifier? */, "#").concat(currentTemplate.name),
                                 parameters: parametersToPass,
                                 content: replaceParameters(currentTemplate.content, parametersToPass) /* <- [2] */,
                                 modelRequirements: currentTemplate.modelRequirements,
@@ -1609,7 +1953,7 @@ function createPromptbookExecutor(options) {
                                 // TODO: [🧠] Maybe put other executionTypes into report
                                 executionReport.promptExecutions.push({
                                     prompt: {
-                                        title: currentTemplate.title /* <- Note: If title in promptbook contains emojis, pass it innto report */,
+                                        title: currentTemplate.title /* <- Note: If title in pipeline contains emojis, pass it innto report */,
                                         content: prompt.content,
                                         modelRequirements: prompt.modelRequirements,
                                         expectations: prompt.expectations,
@@ -1645,7 +1989,7 @@ function createPromptbookExecutor(options) {
                                     // <- [3]
                                 });
                             }
-                            parametersToPass = __assign(__assign({}, parametersToPass), (_m = {}, _m[currentTemplate.resultingParameterName] = resultString /* <- Note: Not need to detect parameter collision here because Promptbook checks logic consistency during construction */, _m));
+                            parametersToPass = __assign(__assign({}, parametersToPass), (_m = {}, _m[currentTemplate.resultingParameterName] = resultString /* <- Note: Not need to detect parameter collision here because pipeline checks logic consistency during construction */, _m));
                             return [2 /*return*/];
                     }
                 });
@@ -1658,17 +2002,17 @@ function createPromptbookExecutor(options) {
                 case 0:
                     parametersToPass = inputParameters;
                     executionReport = {
-                        promptbookUrl: promptbook.promptbookUrl,
-                        title: promptbook.title,
+                        pipelineUrl: pipeline.pipelineUrl,
+                        title: pipeline.title,
                         promptbookUsedVersion: PROMPTBOOK_VERSION,
-                        promptbookRequestedVersion: promptbook.promptbookVersion,
-                        description: promptbook.description,
+                        promptbookRequestedVersion: pipeline.promptbookVersion,
+                        description: pipeline.description,
                         promptExecutions: [],
                     };
                     _d.label = 1;
                 case 1:
                     _d.trys.push([1, 6, , 7]);
-                    resovedParameters_1 = promptbook.parameters
+                    resovedParameters_1 = pipeline.parameters
                         .filter(function (_a) {
                         var isInput = _a.isInput;
                         return isInput;
@@ -1677,7 +2021,7 @@ function createPromptbookExecutor(options) {
                         var name = _a.name;
                         return name;
                     });
-                    unresovedTemplates = __spreadArray([], __read(promptbook.promptTemplates), false);
+                    unresovedTemplates = __spreadArray([], __read(pipeline.promptTemplates), false);
                     resolving_1 = [];
                     loopLimit = LOOP_LIMIT;
                     _loop_1 = function () {
@@ -1686,7 +2030,7 @@ function createPromptbookExecutor(options) {
                             switch (_e.label) {
                                 case 0:
                                     if (loopLimit-- < 0) {
-                                        throw new UnexpectedError('Loop limit reached during resolving parameters promptbook execution');
+                                        throw new UnexpectedError('Loop limit reached during resolving parameters pipeline execution');
                                     }
                                     currentTemplate = unresovedTemplates.find(function (template) {
                                         return template.dependentParameterNames.every(function (name) { return resovedParameters_1.includes(name); });
@@ -1735,177 +2079,52 @@ function createPromptbookExecutor(options) {
                         return (result === null || result === void 0 ? void 0 : result.usage) || addUsage();
                     })), false));
                     return [2 /*return*/, {
-                            isSuccessful: false,
-                            errors: [error_1],
-                            usage: usage_1,
-                            executionReport: executionReport,
-                            outputParameters: parametersToPass,
-                        }];
-                case 7:
-                    try {
-                        // Note: Filter ONLY output parameters
-                        for (_a = __values(promptbook.parameters), _b = _a.next(); !_b.done; _b = _a.next()) {
-                            parameter = _b.value;
-                            if (parameter.isOutput) {
-                                continue;
-                            }
-                            delete parametersToPass[parameter.name];
-                        }
-                    }
-                    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-                    finally {
-                        try {
-                            if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
-                        }
-                        finally { if (e_1) throw e_1.error; }
-                    }
-                    usage = addUsage.apply(void 0, __spreadArray([], __read(executionReport.promptExecutions.map(function (_a) {
-                        var result = _a.result;
-                        return (result === null || result === void 0 ? void 0 : result.usage) || addUsage();
-                    })), false));
-                    return [2 /*return*/, {
-                            isSuccessful: true,
-                            errors: [],
-                            usage: usage,
-                            executionReport: executionReport,
-                            outputParameters: parametersToPass,
-                        }];
-            }
-        });
-    }); };
-    return promptbookExecutor;
-}
-/**
- * TODO: [🧠] When not meet expectations in PROMPT_DIALOG, make some way to tell the user
- * TODO: [👧] Strongly type the executors to avoid need of remove nullables whtn noUncheckedIndexedAccess in tsconfig.json
- * Note: CreatePromptbookExecutorOptions are just connected to PromptbookExecutor so do not extract to types folder
- * TODO: [🧠][3] transparent = (report intermediate parameters) / opaque execution = (report only output parameters) progress reporting mode
- */
-
-/**
- * This error indicates that promptbook not found in the library
- */
-var NotFoundError = /** @class */ (function (_super) {
-    __extends(NotFoundError, _super);
-    function NotFoundError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'NotFoundError';
-        Object.setPrototypeOf(_this, NotFoundError.prototype);
-        return _this;
-    }
-    return NotFoundError;
-}(Error));
-
-/**
- * This error indicates errors in referencing promptbooks between each other
- */
-var ReferenceError$1 = /** @class */ (function (_super) {
-    __extends(ReferenceError, _super);
-    function ReferenceError(message) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'ReferenceError';
-        Object.setPrototypeOf(_this, ReferenceError.prototype);
-        return _this;
-    }
-    return ReferenceError;
-}(Error));
-
-/**
- * Library of promptbooks that groups together promptbooks for an application.
- * This implementation is a very thin wrapper around the Array / Map of promptbooks.
- *
- * @private use `createCollectionFromJson` instead
- * @see https://github.com/webgptorg/promptbook#promptbook-collection
- */
-var SimplePipelineCollection = /** @class */ (function () {
-    /**
-     * Constructs a promptbook library from promptbooks
-     *
-     * @param promptbooks !!!
-     *
-     * @private Use instead `createCollectionFromJson`
-     * Note: During the construction logic of all promptbooks are validated
-     * Note: It is not recommended to use this constructor directly, use `createCollectionFromJson` *(or other variant)* instead
-     */
-    function SimplePipelineCollection() {
-        var e_1, _a;
-        var promptbooks = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            promptbooks[_i] = arguments[_i];
-        }
-        this.library = new Map();
-        try {
-            for (var promptbooks_1 = __values(promptbooks), promptbooks_1_1 = promptbooks_1.next(); !promptbooks_1_1.done; promptbooks_1_1 = promptbooks_1.next()) {
-                var promptbook = promptbooks_1_1.value;
-                if (promptbook.promptbookUrl === undefined) {
-                    throw new ReferenceError$1(spaceTrim$1("\n                        Promptbook with name \"".concat(promptbook.title, "\" does not have defined URL\n\n                        Note: Promptbooks without URLs are called anonymous promptbooks\n                              They can be used as standalone promptbooks, but they cannot be referenced by other promptbooks\n                              And also they cannot be used in the promptbook library\n\n                    ")));
-                }
-                validatePipeline(promptbook);
-                // Note: [🦄]
-                if (this.library.has(promptbook.promptbookUrl) &&
-                    pipelineJsonToString(promptbook) !== pipelineJsonToString(this.library.get(promptbook.promptbookUrl))) {
-                    throw new ReferenceError$1(spaceTrim$1("\n                        Promptbook with URL \"".concat(promptbook.promptbookUrl, "\" is already in the library\n\n                        Note: Promptbooks with the same URL are not allowed\n                        Note: Automatically check whether the promptbooks are the same BUT they are DIFFERENT\n\n                    ")));
-                }
-                this.library.set(promptbook.promptbookUrl, promptbook);
-            }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (promptbooks_1_1 && !promptbooks_1_1.done && (_a = promptbooks_1.return)) _a.call(promptbooks_1);
-            }
-            finally { if (e_1) throw e_1.error; }
-        }
-    }
-    /**
-     * Gets all promptbooks in the library
-     */
-    SimplePipelineCollection.prototype.listPipelines = function () {
-        return Array.from(this.library.keys());
-    };
-    /**
-     * Gets promptbook by its URL
-     *
-     * Note: This is not a direct fetching from the URL, but a lookup in the library
-     */
-    SimplePipelineCollection.prototype.getPipelineByUrl = function (url) {
-        var _this = this;
-        var promptbook = this.library.get(url);
-        if (!promptbook) {
-            if (this.listPipelines().length === 0) {
-                throw new NotFoundError(spaceTrim$1("\n                            Promptbook with url \"".concat(url, "\" not found\n\n                            No promptbooks available\n                        ")));
+                            isSuccessful: false,
+                            errors: [error_1],
+                            usage: usage_1,
+                            executionReport: executionReport,
+                            outputParameters: parametersToPass,
+                        }];
+                case 7:
+                    try {
+                        // Note: Filter ONLY output parameters
+                        for (_a = __values(pipeline.parameters), _b = _a.next(); !_b.done; _b = _a.next()) {
+                            parameter = _b.value;
+                            if (parameter.isOutput) {
+                                continue;
+                            }
+                            delete parametersToPass[parameter.name];
+                        }
+                    }
+                    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                    finally {
+                        try {
+                            if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
+                        }
+                        finally { if (e_1) throw e_1.error; }
+                    }
+                    usage = addUsage.apply(void 0, __spreadArray([], __read(executionReport.promptExecutions.map(function (_a) {
+                        var result = _a.result;
+                        return (result === null || result === void 0 ? void 0 : result.usage) || addUsage();
+                    })), false));
+                    return [2 /*return*/, {
+                            isSuccessful: true,
+                            errors: [],
+                            usage: usage,
+                            executionReport: executionReport,
+                            outputParameters: parametersToPass,
+                        }];
             }
-            throw new NotFoundError(spaceTrim$1(function (block) { return "\n                        Promptbook with url \"".concat(url, "\" not found\n\n                        Available promptbooks:\n                        ").concat(block(_this.listPipelines()
-                .map(function (promptbookUrl) { return "- ".concat(promptbookUrl); })
-                .join('\n')), "\n\n                    "); }));
-        }
-        return promptbook;
-    };
-    /**
-     * Checks whether given prompt was defined in any promptbook in the library
-     */
-    SimplePipelineCollection.prototype.isResponsibleForPrompt = function (prompt) {
-        return true;
-    };
-    return SimplePipelineCollection;
-}());
-
+        });
+    }); };
+    return pipelineExecutor;
+}
 /**
- * Creates PipelineCollection from array of PipelineJson or PipelineString
- *
- * Note: Functions `libraryToJson` and `createCollectionFromJson` are complementary
- * Note: During the construction syntax and logic of all sources are validated
- *
- * @param promptbookSources
- * @returns PipelineCollection
+ * TODO: [🧠] When not meet expectations in PROMPT_DIALOG, make some way to tell the user
+ * TODO: [👧] Strongly type the executors to avoid need of remove nullables whtn noUncheckedIndexedAccess in tsconfig.json
+ * Note: CreatePipelineExecutorOptions are just connected to PipelineExecutor so do not extract to types folder
+ * TODO: [🧠][3] transparent = (report intermediate parameters) / opaque execution = (report only output parameters) progress reporting mode
  */
-function createCollectionFromJson() {
-    var promptbooks = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        promptbooks[_i] = arguments[_i];
-    }
-    return new (SimplePipelineCollection.bind.apply(SimplePipelineCollection, __spreadArray([void 0], __read(promptbooks), false)))();
-}
 
 /* tslint:disable */
 function normalizeToKebabCase(sentence) {
@@ -1964,18 +2183,18 @@ function normalizeToKebabCase(sentence) {
 
 function prepareKnowledgeFromMarkdown(options) {
     return __awaiter(this, void 0, void 0, function () {
-        var content, llmTools, _a, isVerbose, library, prepareKnowledgeFromMarkdownPromptbook, prepareKnowledgeFromMarkdownExecutor, prepareKeywordsPromptbook, prepareKeywordsExecutor, result, outputParameters, knowledgeRaw, knowledgeTextPieces, knowledge;
+        var content, llmTools, _a, isVerbose, collection, prepareKnowledgeFromMarkdownPromptbook, prepareKnowledgeFromMarkdownExecutor, prepareKeywordsPromptbook, prepareKeywordsExecutor, result, outputParameters, knowledgeRaw, knowledgeTextPieces, knowledge;
         var _this = this;
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
                     content = options.content, llmTools = options.llmTools, _a = options.isVerbose, isVerbose = _a === void 0 ? false : _a;
-                    library = createCollectionFromJson.apply(void 0, __spreadArray([], __read(PipelineCollection), false));
-                    return [4 /*yield*/, library.getPipelineByUrl('https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md')];
+                    collection = createCollectionFromJson.apply(void 0, __spreadArray([], __read(PipelineCollection), false));
+                    return [4 /*yield*/, collection.getPipelineByUrl('https://promptbook.studio/promptbook/prepare-knowledge-from-markdown.ptbk.md')];
                 case 1:
                     prepareKnowledgeFromMarkdownPromptbook = _b.sent();
-                    prepareKnowledgeFromMarkdownExecutor = createPromptbookExecutor({
-                        promptbook: prepareKnowledgeFromMarkdownPromptbook,
+                    prepareKnowledgeFromMarkdownExecutor = createPipelineExecutor({
+                        pipeline: prepareKnowledgeFromMarkdownPromptbook,
                         tools: {
                             llm: llmTools,
                             script: [
@@ -1983,11 +2202,11 @@ function prepareKnowledgeFromMarkdown(options) {
                             ],
                         },
                     });
-                    return [4 /*yield*/, library.getPipelineByUrl('https://promptbook.studio/promptbook/prepare-keywords.ptbk.md')];
+                    return [4 /*yield*/, collection.getPipelineByUrl('https://promptbook.studio/promptbook/prepare-keywords.ptbk.md')];
                 case 2:
                     prepareKeywordsPromptbook = _b.sent();
-                    prepareKeywordsExecutor = createPromptbookExecutor({
-                        promptbook: prepareKeywordsPromptbook,
+                    prepareKeywordsExecutor = createPipelineExecutor({
+                        pipeline: prepareKeywordsPromptbook,
                         tools: {
                             llm: llmTools,
                             script: [
@@ -2681,28 +2900,31 @@ function parseCommand(listItem) {
         .map(function (part) { return part.trim(); })
         .filter(function (item) { return item !== ''; })
         .filter(function (item) { return !/^PTBK$/i.test(item); })
+        .filter(function (item) { return !/^PIPELINE$/i.test(item); })
         .filter(function (item) { return !/^PROMPTBOOK$/i.test(item); })
         .map(removeMarkdownFormatting);
     if (type.startsWith('URL') ||
         type.startsWith('PTBK_URL') ||
         type.startsWith('PTBKURL') ||
+        type.startsWith('PIPELINE_URL') ||
+        type.startsWith('PIPELINEURL') ||
         type.startsWith('PROMPTBOOK_URL') ||
         type.startsWith('PROMPTBOOKURL') ||
         type.startsWith('HTTPS')) {
         if (!(listItemParts.length === 2 || (listItemParts.length === 1 && type.startsWith('HTTPS')))) {
-            throw new SyntaxError(spaceTrim$1("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n                    ")));
+            throw new SyntaxError(spaceTrim$1("\n                        Invalid PIPELINE_URL command:\n\n                        - ".concat(listItem, "\n                    ")));
         }
-        var promptbookUrlString = listItemParts.pop();
-        var promptbookUrl = new URL(promptbookUrlString);
-        if (promptbookUrl.protocol !== 'https:') {
-            throw new SyntaxError(spaceTrim$1("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n\n                        Protocol must be HTTPS\n                    ")));
+        var pipelineUrlString = listItemParts.pop();
+        var pipelineUrl = new URL(pipelineUrlString);
+        if (pipelineUrl.protocol !== 'https:') {
+            throw new SyntaxError(spaceTrim$1("\n                        Invalid PIPELINE_URL command:\n\n                        - ".concat(listItem, "\n\n                        Protocol must be HTTPS\n                    ")));
         }
-        if (promptbookUrl.hash !== '') {
-            throw new SyntaxError(spaceTrim$1("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n\n                        URL must not contain hash\n                        Hash is used for identification of the prompt template in the pipeline\n                    ")));
+        if (pipelineUrl.hash !== '') {
+            throw new SyntaxError(spaceTrim$1("\n                        Invalid PIPELINE_URL command:\n\n                        - ".concat(listItem, "\n\n                        URL must not contain hash\n                        Hash is used for identification of the prompt template in the pipeline\n                    ")));
         }
         return {
-            type: 'PROMPTBOOK_URL',
-            promptbookUrl: promptbookUrl,
+            type: 'PIPELINE_URL',
+            pipelineUrl: pipelineUrl,
         };
     }
     else if (type.startsWith('PROMPTBOOK_VERSION') || type.startsWith('PTBK_VERSION')) {
@@ -2894,7 +3116,7 @@ function parseCommand(listItem) {
     */
     }
     else {
-        throw new SyntaxError(spaceTrim$1("\n                    Unknown command:\n\n                    - ".concat(listItem, "\n\n                    Supported commands are:\n                    - PROMPTBOOK_URL <url>\n                    - PROMPTBOOK_VERSION <version>\n                    - EXECUTE PROMPT TEMPLATE\n                    - EXECUTE SIMPLE TEMPLATE\n                    -         SIMPLE TEMPLATE\n                    - EXECUTE SCRIPT\n                    - EXECUTE PROMPT_DIALOG'\n                    -         PROMPT_DIALOG'\n                    - MODEL NAME <name>\n                    - MODEL VARIANT <\"Chat\"|\"Completion\">\n                    - INPUT  PARAM {<name>} <description>\n                    - OUTPUT PARAM {<name>} <description>\n                    - POSTPROCESS `{functionName}`\n                    - JOKER {<name>}\n                    - EXPECT JSON\n                    - EXPECT <\"Exactly\"|\"Min\"|\"Max\"> <number> <\"Chars\"|\"Words\"|\"Sentences\"|\"Paragraphs\"|\"Pages\">\n\n                ")));
+        throw new SyntaxError(spaceTrim$1("\n                    Unknown command:\n\n                    - ".concat(listItem, "\n\n                    Supported commands are:\n                    - PIPELINE_URL <url>\n                    - PROMPTBOOK_VERSION <version>\n                    - EXECUTE PROMPT TEMPLATE\n                    - EXECUTE SIMPLE TEMPLATE\n                    -         SIMPLE TEMPLATE\n                    - EXECUTE SCRIPT\n                    - EXECUTE PROMPT_DIALOG'\n                    -         PROMPT_DIALOG'\n                    - MODEL NAME <name>\n                    - MODEL VARIANT <\"Chat\"|\"Completion\">\n                    - INPUT  PARAM {<name>} <description>\n                    - OUTPUT PARAM {<name>} <description>\n                    - POSTPROCESS `{functionName}`\n                    - JOKER {<name>}\n                    - EXPECT JSON\n                    - EXPECT <\"Exactly\"|\"Min\"|\"Max\"> <number> <\"Chars\"|\"Words\"|\"Sentences\"|\"Paragraphs\"|\"Pages\">\n\n                ")));
     }
 }
 
@@ -2943,7 +3165,7 @@ function pipelineStringToJsonSync(pipelineString) {
     var pipelineJson = {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         title: undefined /* <- Note: Putting here placeholder to keep `title` on top at final JSON */,
-        promptbookUrl: undefined /* <- Note: Putting here placeholder to keep `promptbookUrl` on top at final JSON */,
+        pipelineUrl: undefined /* <- Note: Putting here placeholder to keep `pipelineUrl` on top at final JSON */,
         promptbookVersion: PROMPTBOOK_VERSION,
         description: undefined /* <- Note: Putting here placeholder to keep `description` on top at final JSON */,
         parameters: [],
@@ -3006,8 +3228,8 @@ function pipelineStringToJsonSync(pipelineString) {
             var listItem = listItems_1_1.value;
             var command = parseCommand(listItem);
             switch (command.type) {
-                case 'PROMPTBOOK_URL':
-                    pipelineJson.promptbookUrl = command.promptbookUrl.href;
+                case 'PIPELINE_URL':
+                    pipelineJson.pipelineUrl = command.pipelineUrl.href;
                     break;
                 case 'PROMPTBOOK_VERSION':
                     pipelineJson.promptbookVersion = command.promptbookVersion;
@@ -3362,7 +3584,7 @@ function renderPromptbookMermaid(pipelineJson, options) {
     return promptbookMermaid;
 }
 /**
- * TODO: Maybe use some Mermaid library instead of string templating
+ * TODO: Maybe use some Mermaid package instead of string templating
  * TODO: [🕌] When more than 2 functionalities, split into separate functions
  */
 
@@ -3401,12 +3623,12 @@ function prettifyPipelineString(pipelineString, options) {
     });
 }
 /**
- * TODO: Maybe use some Mermaid library instead of string templating
+ * TODO: Maybe use some Mermaid package instead of string templating
  * TODO: [🕌] When more than 2 functionalities, split into separate functions
  */
 
 /**
- * This error indicates that the promptbook library cannot be propperly loaded
+ * This error indicates that the pipeline collection cannot be propperly loaded
  */
 var CollectionError = /** @class */ (function (_super) {
     __extends(CollectionError, _super);
@@ -3507,225 +3729,6 @@ var SimplePromptInterfaceTools = /** @class */ (function () {
     return SimplePromptInterfaceTools;
 }());
 
-/**
- * Constructs Promptbook from async sources
- * It can be one of the following:
- * - Promise of array of PipelineJson or PipelineString
- * - Factory function that returns Promise of array of PipelineJson or PipelineString
- *
- * Note: This is useful as internal tool for other constructor functions like
- *       `createCollectionFromUrl` or `createCollectionFromDirectory`
- *       Consider using those functions instead of this one
- *
- * Note: The function does NOT return promise it returns the library directly which waits for the sources to be resolved
- *       when error occurs in given promise or factory function, it is thrown during `listPipelines` or `getPipelineByUrl` call
- *
- * Note: Consider using  `createCollectionFromDirectory` or `createCollectionFromUrl`
- *
- * @param promptbookSourcesPromiseOrFactory
- * @returns PipelineCollection
- * @deprecated Do not use, it will became internal tool for other constructor functions
- */
-function createCollectionFromPromise(promptbookSourcesPromiseOrFactory) {
-    var library;
-    function forSources() {
-        return __awaiter(this, void 0, void 0, function () {
-            var promptbookSources;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        if (typeof promptbookSourcesPromiseOrFactory === 'function') {
-                            // Note: Calling factory function only once despite multiple calls to resolveSources
-                            promptbookSourcesPromiseOrFactory = promptbookSourcesPromiseOrFactory();
-                        }
-                        return [4 /*yield*/, promptbookSourcesPromiseOrFactory];
-                    case 1:
-                        promptbookSources = _a.sent();
-                        library = createCollectionFromJson.apply(void 0, __spreadArray([], __read(promptbookSources), false));
-                        return [2 /*return*/];
-                }
-            });
-        });
-    }
-    function listPipelines() {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, forSources()];
-                    case 1:
-                        _a.sent();
-                        return [2 /*return*/, /* not await */ library.listPipelines()];
-                }
-            });
-        });
-    }
-    function getPipelineByUrl(url) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, forSources()];
-                    case 1:
-                        _a.sent();
-                        return [2 /*return*/, /* not await */ library.getPipelineByUrl(url)];
-                }
-            });
-        });
-    }
-    function isResponsibleForPrompt(prompt) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, forSources()];
-                    case 1:
-                        _a.sent();
-                        return [2 /*return*/, /* not await */ library.isResponsibleForPrompt(prompt)];
-                }
-            });
-        });
-    }
-    return {
-        listPipelines: listPipelines,
-        getPipelineByUrl: getPipelineByUrl,
-        isResponsibleForPrompt: isResponsibleForPrompt,
-    };
-}
-
-/**
- * Constructs Promptbook from remote Promptbase URL
-
- * @returns PipelineCollection
- */
-function createCollectionFromUrl(url, options) {
-    return __awaiter(this, void 0, void 0, function () {
-        var _a, _b, isVerbose, _c, isLazyLoaded, library;
-        var _this = this;
-        return __generator(this, function (_d) {
-            switch (_d.label) {
-                case 0:
-                    _a = options || {}, _b = _a.isVerbose, isVerbose = _b === void 0 ? false : _b, _c = _a.isLazyLoaded, isLazyLoaded = _c === void 0 ? false : _c;
-                    library = createCollectionFromPromise(function () { return __awaiter(_this, void 0, void 0, function () {
-                        return __generator(this, function (_a) {
-                            if (isVerbose) {
-                                console.info("Creating promptbook library from url ".concat(url.toString()));
-                            }
-                            throw new Error('Not implemented yet');
-                        });
-                    }); });
-                    if (!(isLazyLoaded === false)) return [3 /*break*/, 2];
-                    return [4 /*yield*/, library.listPipelines()];
-                case 1:
-                    _d.sent();
-                    _d.label = 2;
-                case 2: return [2 /*return*/, library];
-            }
-        });
-    });
-}
-/**
- * TODO: !!!! [🧠] Library precompilation and do not mix markdown and json promptbooks
- */
-
-/**
- * Creates PipelineCollection as a subset of another PipelineCollection
- *
- * Note: You can use any type of library as a parent library - local, remote, etc.
- * Note: This is just a thin wrapper / proxy around the parent library
- *
- * @param promptbookSources
- * @returns PipelineCollection
- */
-function createSubcollection(library, predicate) {
-    function listPipelines() {
-        return __awaiter(this, void 0, void 0, function () {
-            var promptbooks;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, library.listPipelines()];
-                    case 1:
-                        promptbooks = _a.sent();
-                        promptbooks = promptbooks.filter(predicate);
-                        return [2 /*return*/, promptbooks];
-                }
-            });
-        });
-    }
-    function getPipelineByUrl(url) {
-        return __awaiter(this, void 0, void 0, function () {
-            var _a, promptbook;
-            var _this = this;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        if (!!predicate(url)) return [3 /*break*/, 2];
-                        _a = NotFoundError.bind;
-                        return [4 /*yield*/, spaceTrim$1(function (block) { return __awaiter(_this, void 0, void 0, function () {
-                                var _a, _b, _c, _d, _e, _f;
-                                return __generator(this, function (_g) {
-                                    switch (_g.label) {
-                                        case 0:
-                                            _c = (_b = "\n                        Promptbook with url \"".concat(url, "\" not found or not accessible\n\n                        Available promptbooks:\n                        ")).concat;
-                                            _d = block;
-                                            return [4 /*yield*/, listPipelines()];
-                                        case 1:
-                                            _e = (_a = _c.apply(_b, [_d.apply(void 0, [(_g.sent()).map(function (promptbookUrl) { return "- ".concat(promptbookUrl); }).join('\n')]), "\n\n                        All available promptbooks in parent library:\n                        "])).concat;
-                                            _f = block;
-                                            return [4 /*yield*/, library.listPipelines()];
-                                        case 2: return [2 /*return*/, _e.apply(_a, [_f.apply(void 0, [(_g.sent()).map(function (promptbookUrl) { return "- ".concat(promptbookUrl); }).join('\n')]), "\n\n                    "])];
-                                    }
-                                });
-                            }); })];
-                    case 1: throw new (_a.apply(NotFoundError, [void 0, _b.sent()]))();
-                    case 2: return [4 /*yield*/, library.getPipelineByUrl(url)];
-                    case 3:
-                        promptbook = _b.sent();
-                        return [2 /*return*/, promptbook];
-                }
-            });
-        });
-    }
-    function isResponsibleForPrompt(prompt) {
-        return __awaiter(this, void 0, void 0, function () {
-            var isResponsible;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, library.isResponsibleForPrompt(prompt)];
-                    case 1:
-                        isResponsible = _a.sent();
-                        // TODO: !! Only if responsible, check if predicate is true
-                        return [2 /*return*/, isResponsible];
-                }
-            });
-        });
-    }
-    return {
-        listPipelines: listPipelines,
-        getPipelineByUrl: getPipelineByUrl,
-        isResponsibleForPrompt: isResponsibleForPrompt,
-    };
-}
-
-/**
- * Converts PipelineCollection to serialized JSON
- *
- * Note: Functions `libraryToJson` and `createCollectionFromJson` are complementary
- */
-function libraryToJson(library) {
-    return __awaiter(this, void 0, void 0, function () {
-        var promptbookUrls, promptbooks;
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0: return [4 /*yield*/, library.listPipelines()];
-                case 1:
-                    promptbookUrls = _a.sent();
-                    return [4 /*yield*/, Promise.all(promptbookUrls.map(function (url) { return library.getPipelineByUrl(url); }))];
-                case 2:
-                    promptbooks = _a.sent();
-                    return [2 /*return*/, promptbooks];
-            }
-        });
-    });
-}
-
 /**
  * Multiple LLM Execution Tools is a proxy server that uses multiple execution tools internally and exposes the executor interface externally.
  *
@@ -3958,7 +3961,7 @@ function escapeMarkdownBlock(value) {
 }
 
 /**
- * The thresholds for the relative time in the `moment` library.
+ * The thresholds for the relative time in the `moment` NPM package.
  *
  * @see https://momentjscom.readthedocs.io/en/latest/moment/07-customization/13-relative-time-threshold/
  */
@@ -4008,8 +4011,8 @@ function executionReportJsonToString(executionReportJson, options) {
     var _h = __assign(__assign({}, ExecutionReportStringOptionsDefaults), (options || {})), taxRate = _h.taxRate, chartsWidth = _h.chartsWidth;
     var executionReportString = spaceTrim$1(function (block) { return "\n            # ".concat(executionReportJson.title || 'Execution report', "\n\n            ").concat(block(executionReportJson.description || ''), "\n          "); });
     var headerList = [];
-    if (executionReportJson.promptbookUrl) {
-        headerList.push("PROMPTBOOK URL ".concat(executionReportJson.promptbookUrl));
+    if (executionReportJson.pipelineUrl) {
+        headerList.push("PIPELINE URL ".concat(executionReportJson.pipelineUrl));
     }
     headerList.push("PROMPTBOOK VERSION ".concat(executionReportJson.promptbookUsedVersion) +
         (!executionReportJson.promptbookRequestedVersion
@@ -4160,5 +4163,5 @@ function executionReportJsonToString(executionReportJson, options) {
  * TODO: [🧠] Allow to filter out some parts of the report by options
  */
 
-export { CallbackInterfaceTools, CollectionError, ExecutionError, ExecutionReportStringOptionsDefaults, ExecutionTypes, ExpectError, MultipleLlmExecutionTools, NotFoundError, PROMPTBOOK_VERSION, PipelineLogicError, ReferenceError$1 as ReferenceError, SimplePromptInterfaceTools, SyntaxError, TemplateError, UnexpectedError, addUsage, assertsExecutionSuccessful, checkExpectations, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createPromptbookExecutor, createSubcollection as createSublibrary, embeddingVectorToString, executionReportJsonToString, isPassingExpectations, libraryToJson, pipelineJsonToString, pipelineStringToJson, pipelineStringToJsonSync, prepareKnowledgeFromMarkdown, prettifyPipelineString, usageToWorktime, validatePipeline };
+export { CallbackInterfaceTools, CollectionError, ExecutionError, ExecutionReportStringOptionsDefaults, ExecutionTypes, ExpectError, MultipleLlmExecutionTools, NotFoundError, PROMPTBOOK_VERSION, PipelineLogicError, ReferenceError$1 as ReferenceError, SimplePromptInterfaceTools, SyntaxError, TemplateError, UnexpectedError, addUsage, assertsExecutionSuccessful, checkExpectations, collectionToJson, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createPipelineExecutor, createSubcollection as createSublibrary, embeddingVectorToString, executionReportJsonToString, isPassingExpectations, pipelineJsonToString, pipelineStringToJson, pipelineStringToJsonSync, prepareKnowledgeFromMarkdown, prettifyPipelineString, usageToWorktime, validatePipeline };
 //# sourceMappingURL=index.es.js.map