@promptbook/core 0.35.1 → 0.36.2

package/umd/index.umd.js

@@ -127,21 +127,6 @@
         return to.concat(ar || Array.prototype.slice.call(from));
     }
 
-    /**
-     * Default model requirements for the pipeline
-     *
-     * Note: As default, we use the chat model gpt-3.5-turbo. For most tasks, this is the best model with most intuitive usage.
-     *       GPT-4 is overkill for most tasks so keeping it as opt-in option.
-     */
-    var DEFAULT_MODEL_REQUIREMENTS = {
-        modelVariant: 'CHAT',
-        modelName: 'gpt-3.5-turbo',
-    };
-    /**
-     * TODO: !!! Different default model for different model variant
-     * TODO: [🧠] What should be the default model?
-     */
-
     /**
      * Supported script languages
      */
@@ -442,6 +427,11 @@
         return spaceTrim__default["default"](content.replace(/<!--(.*?)-->/gs, ''));
     }
 
+    /**
+     * The version of the Promptbook library
+     */
+    var PROMPTBOOK_VERSION = '0.36.1';
+
     /**
      * Execution type describes the way how the block is executed
      *
@@ -559,36 +549,39 @@
             .map(function (part) { return part.trim(); })
             .filter(function (item) { return item !== ''; })
             .filter(function (item) { return !/^PTBK$/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('PROMPTBOOK_URL') ||
+            type.startsWith('PROMPTBOOKURL') ||
             type.startsWith('HTTPS')) {
             if (!(listItemParts.length === 2 || (listItemParts.length === 1 && type.startsWith('HTTPS')))) {
-                throw new Error(spaceTrim__default["default"]("\n                        Invalid PTBK_URL command:\n\n                        - ".concat(listItem, "\n                    ")));
+                throw new Error(spaceTrim__default["default"]("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n                    ")));
             }
-            var ptbkUrlString = listItemParts.pop();
-            var ptbkUrl = new URL(ptbkUrlString);
-            if (ptbkUrl.protocol !== 'https:') {
-                throw new Error(spaceTrim__default["default"]("\n                        Invalid PTBK_URL command:\n\n                        - ".concat(listItem, "\n\n                        Protocol must be HTTPS\n                    ")));
+            var promptbookUrlString = listItemParts.pop();
+            var promptbookUrl = new URL(promptbookUrlString);
+            if (promptbookUrl.protocol !== 'https:') {
+                throw new Error(spaceTrim__default["default"]("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n\n                        Protocol must be HTTPS\n                    ")));
             }
-            if (ptbkUrl.hash !== '') {
-                throw new Error(spaceTrim__default["default"]("\n                        Invalid PTBK_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 (promptbookUrl.hash !== '') {
+                throw new Error(spaceTrim__default["default"]("\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                    ")));
             }
             return {
-                type: 'PTBK_URL',
-                ptbkUrl: ptbkUrl,
+                type: 'PROMPTBOOK_URL',
+                promptbookUrl: promptbookUrl,
             };
         }
-        else if (type.startsWith('PTBK_VERSION')) {
+        else if (type.startsWith('PROMPTBOOK_VERSION') || type.startsWith('PTBK_VERSION')) {
             if (listItemParts.length !== 2) {
-                throw new Error(spaceTrim__default["default"]("\n                        Invalid PTBK_VERSION command:\n\n                        - ".concat(listItem, "\n                    ")));
+                throw new Error(spaceTrim__default["default"]("\n                        Invalid PROMPTBOOK_VERSION command:\n\n                        - ".concat(listItem, "\n                    ")));
             }
-            var ptbkVersion = listItemParts.pop();
+            var promptbookVersion = listItemParts.pop();
             // TODO: Validate version
             return {
-                type: 'PTBK_VERSION',
-                ptbkVersion: ptbkVersion,
+                type: 'PROMPTBOOK_VERSION',
+                promptbookVersion: promptbookVersion,
             };
         }
         else if (type.startsWith('EXECUTE') ||
@@ -633,7 +626,7 @@
                 };
             }
             else {
-                throw new Error(spaceTrim__default["default"](function (block) { return "\n                          Unknown model key in command:\n\n                          - ".concat(listItem, "\n\n                          Supported model keys are:\n                          ").concat(block(['variant', 'name'].join(', ')), "\n\n                          Example:\n\n                          - MODEL VARIANT CHAT\n                          - MODEL NAME gpt-4\n                    "); }));
+                throw new Error(spaceTrim__default["default"](function (block) { return "\n                          Unknown model key in command:\n\n                          - ".concat(listItem, "\n\n                          Supported model keys are:\n                          ").concat(block(['variant', 'name'].join(', ')), "\n\n                          Example:\n\n                          - MODEL VARIANT Chat\n                          - MODEL NAME gpt-4\n                    "); }));
             }
         }
         else if (type.startsWith('PARAM') ||
@@ -759,41 +752,36 @@
             }
         }
         else {
-            throw new Error(spaceTrim__default["default"]("\n                    Unknown command:\n\n                    - ".concat(listItem, "\n\n                    Supported commands are:\n                    - Execute\n                    - Model\n                    - Parameter\n                    - INPUT  PARAMETER\n                    - OUTPUT PARAMETER\n                    - PTBK VERSION\n                ")));
+            throw new Error(spaceTrim__default["default"]("\n                    Unknown command:\n\n                    - ".concat(listItem, "\n\n                    Supported commands are:\n                    - Execute\n                    - Model\n                    - Parameter\n                    - INPUT  PARAMETER\n                    - OUTPUT PARAMETER\n                    - PROMPTBOOK VERSION\n                ")));
         }
     }
 
     /**
-     * The version of the Promptbook library
-     */
-    var PTBK_VERSION = '0.35.0';
-
-    /**
-     * Parse prompt template pipeline from string format to JSON format
+     * Parse promptbook from string format to JSON format
      *
      * Note: This function does not validate logic of the pipeline only the syntax
      */
-    function promptTemplatePipelineStringToJson(promptTemplatePipelineString) {
+    function promptbookStringToJson(promptbookString) {
         var e_1, _a, e_2, _b;
-        var ptbJson = {
+        var promptbookJson = {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             title: undefined /* <- Note: Putting here placeholder to keep `title` on top at final JSON */,
-            ptbkUrl: undefined /* <- Note: Putting here placeholder to keep `ptbkUrl` on top at final JSON */,
-            ptbkVersion: PTBK_VERSION,
+            promptbookUrl: undefined /* <- Note: Putting here placeholder to keep `promptbookUrl` on top at final JSON */,
+            promptbookVersion: PROMPTBOOK_VERSION,
             description: undefined /* <- Note: Putting here placeholder to keep `description` on top at final JSON */,
             parameters: [],
             promptTemplates: [],
         };
         // =============================================================
-        // Note: 1️⃣ Normalization of the PTP string
-        promptTemplatePipelineString = removeContentComments(promptTemplatePipelineString);
-        promptTemplatePipelineString = promptTemplatePipelineString.replaceAll(/`\{(?<paramName>[a-z0-9_]+)\}`/gi, '{$<paramName>}');
-        promptTemplatePipelineString = promptTemplatePipelineString.replaceAll(/`->\s+\{(?<paramName>[a-z0-9_]+)\}`/gi, '-> {$<paramName>}');
+        // Note: 1️⃣ Normalization of the PROMPTBOOK string
+        promptbookString = removeContentComments(promptbookString);
+        promptbookString = promptbookString.replaceAll(/`\{(?<paramName>[a-z0-9_]+)\}`/gi, '{$<paramName>}');
+        promptbookString = promptbookString.replaceAll(/`->\s+\{(?<paramName>[a-z0-9_]+)\}`/gi, '-> {$<paramName>}');
         // =============================================================
         ///Note: 2️⃣ Function for adding parameters
         var addParam = function (parameterCommand) {
             var parameterName = parameterCommand.parameterName, parameterDescription = parameterCommand.parameterDescription, isInputParameter = parameterCommand.isInputParameter;
-            var existingParameter = ptbJson.parameters.find(function (parameter) { return parameter.name === parameterName; });
+            var existingParameter = promptbookJson.parameters.find(function (parameter) { return parameter.name === parameterName; });
             if (existingParameter &&
                 existingParameter.description &&
                 existingParameter.description !== parameterDescription &&
@@ -806,7 +794,7 @@
                 }
             }
             else {
-                ptbJson.parameters.push({
+                promptbookJson.parameters.push({
                     name: parameterName,
                     description: parameterDescription || undefined,
                     isInput: isInputParameter,
@@ -815,12 +803,12 @@
         };
         // =============================================================
         // Note: 3️⃣ Parse the dynamic part - the template pipeline
-        var markdownStructure = markdownToMarkdownStructure(promptTemplatePipelineString);
+        var markdownStructure = markdownToMarkdownStructure(promptbookString);
         var markdownStructureDeepness = countMarkdownStructureDeepness(markdownStructure);
         if (markdownStructureDeepness !== 2) {
             throw new Error(spaceTrim__default["default"]("\n                Invalid markdown structure.\n                The markdown must have exactly 2 levels of headings (one top-level section and one section for each template).\n                Now it has ".concat(markdownStructureDeepness, " levels of headings.\n            ")));
         }
-        ptbJson.title = markdownStructure.title;
+        promptbookJson.title = markdownStructure.title;
         // TODO: [1] DRY description
         var description = markdownStructure.content;
         // Note: Remove codeblocks
@@ -831,29 +819,28 @@
         if (description === '') {
             description = undefined;
         }
-        ptbJson.description = description;
-        var defaultModelRequirements = __assign({}, DEFAULT_MODEL_REQUIREMENTS);
+        promptbookJson.description = description;
+        var defaultModelRequirements = {};
         var listItems = extractAllListItemsFromMarkdown(markdownStructure.content);
         try {
             for (var listItems_1 = __values(listItems), listItems_1_1 = listItems_1.next(); !listItems_1_1.done; listItems_1_1 = listItems_1.next()) {
                 var listItem = listItems_1_1.value;
                 var command = parseCommand(listItem);
                 switch (command.type) {
-                    case 'PTBK_URL':
-                        ptbJson.ptbkUrl = command.ptbkUrl.href;
+                    case 'PROMPTBOOK_URL':
+                        promptbookJson.promptbookUrl = command.promptbookUrl.href;
                         break;
-                    case 'PTBK_VERSION':
-                        ptbJson.ptbkVersion = command.ptbkVersion;
+                    case 'PROMPTBOOK_VERSION':
+                        promptbookJson.promptbookVersion = command.promptbookVersion;
                         break;
                     case 'MODEL':
-                        // @ts-expect-error [🤸‍♂️] No idea why this occurs after adding maxTokens into modelRequirements
                         defaultModelRequirements[command.key] = command.value;
                         break;
                     case 'PARAMETER':
                         addParam(command);
                         break;
                     default:
-                        throw new Error("Command ".concat(command.type, " is not allowed in the head of the prompt template pipeline ONLY at the prompt template block"));
+                        throw new Error("Command ".concat(command.type, " is not allowed in the head of the promptbook ONLY at the prompt template block"));
                 }
             }
         }
@@ -893,7 +880,6 @@
                             isExecutionTypeChanged = true;
                             break;
                         case 'MODEL':
-                            // @ts-expect-error [🤸‍♂️] No idea why this occurs after adding maxTokens into modelRequirements
                             templateModelRequirements[command.key] = command.value;
                             break;
                         case 'PARAMETER':
@@ -927,7 +913,7 @@
                             expectFormat = command.format;
                             break;
                         default:
-                            throw new Error("Command ".concat(command.type, " is not allowed in the block of the prompt template ONLY at the head of the prompt template pipeline"));
+                            throw new Error("Command ".concat(command.type, " is not allowed in the block of the prompt template ONLY at the head of the promptbook"));
                     }
                 }
             }
@@ -1006,7 +992,7 @@
                 }
             }
             dependentParameterNames = __spreadArray([], __read(new Set(dependentParameterNames)), false);
-            ptbJson.promptTemplates.push({
+            promptbookJson.promptTemplates.push({
                 name: n12.normalizeTo_PascalCase(section.title),
                 title: section.title,
                 description: description_1,
@@ -1036,7 +1022,7 @@
             finally { if (e_2) throw e_2.error; }
         }
         // =============================================================
-        return ptbJson;
+        return promptbookJson;
     }
     /**
      * TODO: Report here line/column of error
@@ -1045,7 +1031,7 @@
      */
 
     /**
-     * Validates PromptTemplatePipelineJson if it is logically valid.
+     * Validates PromptbookJson if it is logically valid.
      *
      * It checks:
      * -   if it has correct parameters dependency
@@ -1054,12 +1040,12 @@
      * -   if it is valid json
      * -   if it is meaningful
      *
-     * @param ptp valid or invalid PromptTemplatePipelineJson
+     * @param promptbook valid or invalid PromptbookJson
      * @throws {Error} if invalid
      */
-    function validatePromptTemplatePipelineJson(ptp) {
+    function validatePromptbookJson(promptbook) {
         var e_1, _a, e_2, _b, e_3, _c;
-        var definedParameters = new Set(ptp.parameters.filter(function (_a) {
+        var definedParameters = new Set(promptbook.parameters.filter(function (_a) {
             var isInput = _a.isInput;
             return isInput;
         }).map(function (_a) {
@@ -1068,11 +1054,16 @@
         }));
         try {
             // Note: Check each template individually
-            for (var _d = __values(ptp.promptTemplates), _e = _d.next(); !_e.done; _e = _d.next()) {
+            for (var _d = __values(promptbook.promptTemplates), _e = _d.next(); !_e.done; _e = _d.next()) {
                 var template = _e.value;
                 if (definedParameters.has(template.resultingParameterName)) {
                     throw new Error("Parameter {".concat(template.resultingParameterName, "} is defined multiple times"));
                 }
+                if (template.executionType === 'PROMPT_TEMPLATE' &&
+                    (template.modelRequirements.modelVariant === undefined ||
+                        template.modelRequirements.modelName === undefined)) {
+                    throw new Error(spaceTrim__default["default"]("\n\n                  You must specify MODEL VARIANT and MODEL NAME in the prompt template \"".concat(template.title, "\"\n\n                  For example:\n                  - MODEL VARIANT Chat\n                  - MODEL NAME `gpt-4-1106-preview`\n\n              ")));
+                }
                 if (template.jokers && template.jokers.length > 0) {
                     if (!template.expectFormat &&
                         !template.expectAmount /* <- TODO: Require at least 1 -> min <- expectation to use jokers */) {
@@ -1128,14 +1119,16 @@
             finally { if (e_1) throw e_1.error; }
         }
         // Note: Detect circular dependencies
-        var resovedParameters = ptp.parameters.filter(function (_a) {
+        var resovedParameters = promptbook.parameters
+            .filter(function (_a) {
             var isInput = _a.isInput;
             return isInput;
-        }).map(function (_a) {
+        })
+            .map(function (_a) {
             var name = _a.name;
             return name;
         });
-        var unresovedTemplates = __spreadArray([], __read(ptp.promptTemplates), false);
+        var unresovedTemplates = __spreadArray([], __read(promptbook.promptTemplates), false);
         var _loop_1 = function () {
             var currentlyResovedTemplates = unresovedTemplates.filter(function (template) {
                 return template.dependentParameterNames.every(function (name) { return resovedParameters.includes(name); });
@@ -1161,15 +1154,15 @@
         }
     }
     /**
-     * TODO: [🧠] Work with ptbkVersion
+     * TODO: [🧠] Work with promptbookVersion
      * TODO: Use here some json-schema, Zod or something similar and change it to:
      *     > /**
-     *     >  * Validates PromptTemplatePipelineJson if it is logically valid.
+     *     >  * Validates PromptbookJson if it is logically valid.
      *     >  *
      *     >  * It checks:
      *     >  * -   it has a valid structure
      *     >  * -   ...
-     *     >  ex port function validatePromptTemplatePipelineJson(ptp: unknown): asserts ptp is PromptTemplatePipelineJson {
+     *     >  ex port function validatePromptbookJson(promptbook: unknown): asserts promptbook is PromptbookJson {
      */
 
     /**
@@ -1326,16 +1319,16 @@
      */
 
     /**
-     * Creates executor function from prompt template pipeline and execution tools.
+     * Creates executor function from promptbook and execution tools.
      *
      * Note: Consider using getExecutor method of the library instead of using this function
      */
-    function createPtpExecutor(options) {
+    function createPromptbookExecutor(options) {
         var _this = this;
-        var ptp = options.ptp, tools = options.tools, _a = options.settings, settings = _a === void 0 ? {} : _a;
+        var promptbook = options.promptbook, tools = options.tools, _a = options.settings, settings = _a === void 0 ? {} : _a;
         var _b = settings.maxExecutionAttempts, maxExecutionAttempts = _b === void 0 ? 3 : _b;
-        validatePromptTemplatePipelineJson(ptp);
-        var ptpExecutor = function (inputParameters, onProgress) { return __awaiter(_this, void 0, void 0, function () {
+        validatePromptbookJson(promptbook);
+        var promptbookExecutor = 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_1_1, _e, _f, functionName, postprocessingError, _g, _h, scriptTools, error_3, e_2_1, e_3_1, _j, _k, _l, unit, _m, max, min, amount, error_4;
@@ -1343,9 +1336,9 @@
                     return __generator(this, function (_t) {
                         switch (_t.label) {
                             case 0:
-                                name = "ptp-executor-frame-".concat(currentTemplate.name);
+                                name = "promptbook-executor-frame-".concat(currentTemplate.name);
                                 title = currentTemplate.title;
-                                priority = ptp.promptTemplates.length - ptp.promptTemplates.indexOf(currentTemplate);
+                                priority = promptbook.promptTemplates.length - promptbook.promptTemplates.indexOf(currentTemplate);
                                 if (!onProgress) return [3 /*break*/, 2];
                                 return [4 /*yield*/, onProgress({
                                         name: name,
@@ -1402,9 +1395,9 @@
                             case 6:
                                 prompt = {
                                     title: currentTemplate.title,
-                                    ptbkUrl: "".concat(ptp.ptbkUrl
-                                        ? ptp.ptbkUrl
-                                        : 'anonymous' /* <- [🧠] !!! How to deal with anonymous PTPs, do here some auto-url like SHA-256 based ad-hoc identifier? */, "#").concat(currentTemplate.name),
+                                    promptbookUrl: "".concat(promptbook.promptbookUrl
+                                        ? promptbook.promptbookUrl
+                                        : 'anonymous' /* <- [🧠][🈴] How to deal with anonymous PROMPTBOOKs, 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,
@@ -1661,7 +1654,7 @@
                                         parameterValue: resultString,
                                     });
                                 }
-                                parametersToPass = __assign(__assign({}, parametersToPass), (_s = {}, _s[currentTemplate.resultingParameterName] = resultString /* <- Note: Not need to detect parameter collision here because PromptTemplatePipeline checks logic consistency during construction */, _s));
+                                parametersToPass = __assign(__assign({}, parametersToPass), (_s = {}, _s[currentTemplate.resultingParameterName] = resultString /* <- Note: Not need to detect parameter collision here because Promptbook checks logic consistency during construction */, _s));
                                 return [2 /*return*/];
                         }
                     });
@@ -1673,17 +1666,17 @@
                     case 0:
                         parametersToPass = inputParameters;
                         executionReport = {
-                            ptbkUrl: ptp.ptbkUrl,
-                            title: ptp.title,
-                            ptbkUsedVersion: PTBK_VERSION,
-                            ptbkRequestedVersion: ptp.ptbkVersion,
-                            description: ptp.description,
+                            promptbookUrl: promptbook.promptbookUrl,
+                            title: promptbook.title,
+                            promptbookUsedVersion: PROMPTBOOK_VERSION,
+                            promptbookRequestedVersion: promptbook.promptbookVersion,
+                            description: promptbook.description,
                             promptExecutions: [],
                         };
                         _a.label = 1;
                     case 1:
                         _a.trys.push([1, 6, , 7]);
-                        resovedParameters_1 = ptp.parameters
+                        resovedParameters_1 = promptbook.parameters
                             .filter(function (_a) {
                             var isInput = _a.isInput;
                             return isInput;
@@ -1692,7 +1685,7 @@
                             var name = _a.name;
                             return name;
                         });
-                        unresovedTemplates = __spreadArray([], __read(ptp.promptTemplates), false);
+                        unresovedTemplates = __spreadArray([], __read(promptbook.promptTemplates), false);
                         resolving_1 = [];
                         _loop_1 = function () {
                             var currentTemplate, work_1;
@@ -1756,50 +1749,50 @@
                 }
             });
         }); };
-        return ptpExecutor;
+        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: CreatePtpExecutorOptions are just connected to PtpExecutor so do not extract to types folder
+     * Note: CreatePromptbookExecutorOptions are just connected to PromptbookExecutor so do not extract to types folder
      */
 
     /**
-     * Library of prompt template pipelines that groups together prompt template pipelines for an application. This is a very thin wrapper around the Array / Set of prompt template pipelines.
+     * Library of promptbooks that groups together promptbooks for an application. This is a very thin wrapper around the Array / Set of promptbooks.
      *
-     * Prompt Template Pipeline library is a useful helper in execution, it can be shared between execution and consumer parts of the app and make common knowledge about prompt template pipelines.
+     * Promptbook library is a useful helper in execution, it can be shared between execution and consumer parts of the app and make common knowledge about promptbooks.
      *
-     * It allows to create executor functions from prompt template pipelines in the library.
+     * It allows to create executor functions from promptbooks in the library.
      *
      * @see https://github.com/webgptorg/promptbook#prompt-template-pipeline-library
      */
-    var PromptTemplatePipelineLibrary = /** @class */ (function () {
-        function PromptTemplatePipelineLibrary(options) {
+    var PromptbookLibrary = /** @class */ (function () {
+        function PromptbookLibrary(options) {
             this.options = options;
         }
         /**
-         * Constructs PromptTemplatePipeline from any sources
+         * Constructs Promptbook from any sources
          *
          * Note: During the construction syntax and logic of all sources are validated
          * Note: You can combine .ptbk.md and .ptbk.json files BUT it is not recommended
          *
-         * @param ptbkSources contents of .ptbk.md or .ptbk.json files
+         * @param promptbookSources contents of .ptbk.md or .ptbk.json files
          * @param settings settings for creating executor functions
-         * @returns PromptTemplatePipelineLibrary
+         * @returns PromptbookLibrary
          */
-        PromptTemplatePipelineLibrary.fromSources = function (ptbkSources, settings) {
+        PromptbookLibrary.fromSources = function (promptbookSources, settings) {
             var e_1, _a;
             var library = {};
             try {
-                for (var _b = __values(Object.entries(ptbkSources)), _c = _b.next(); !_c.done; _c = _b.next()) {
+                for (var _b = __values(Object.entries(promptbookSources)), _c = _b.next(); !_c.done; _c = _b.next()) {
                     var _d = __read(_c.value, 2), name_1 = _d[0], source = _d[1];
                     if (typeof source === 'string') {
                         // Note: When directly creating from string, no need to validate the source
                         //       The validation is performed always before execution
-                        library[name_1] = promptTemplatePipelineStringToJson(source);
+                        library[name_1] = promptbookStringToJson(source);
                     }
                     else {
-                        validatePromptTemplatePipelineJson(source);
+                        validatePromptbookJson(source);
                         library[name_1] = source;
                     }
                 }
@@ -1811,43 +1804,53 @@
                 }
                 finally { if (e_1) throw e_1.error; }
             }
-            return new PromptTemplatePipelineLibrary({ library: library, settings: settings });
+            return new PromptbookLibrary({ library: library, settings: settings });
         };
+        Object.defineProperty(PromptbookLibrary.prototype, "promptbookNames", {
+            /**
+             * Gets all promptbooks in the library
+             */
+            get: function () {
+                return Object.keys(this.options.library);
+            },
+            enumerable: false,
+            configurable: true
+        });
         /**
-         * Gets prompt template pipeline by name
+         * Gets promptbook by name
          */
-        PromptTemplatePipelineLibrary.prototype.getPtp = function (name) {
-            var promptTemplatePipeline = this.options.library[name];
-            if (!promptTemplatePipeline) {
-                throw new Error("Prompt template pipeline with name \"".concat(name, "\" not found"));
+        PromptbookLibrary.prototype.getPromptbookByName = function (name) {
+            var promptbook = this.options.library[name];
+            if (!promptbook) {
+                throw new Error("Promptbook with name \"".concat(name, "\" not found"));
             }
-            return promptTemplatePipeline;
+            return promptbook;
         };
         /**
          * Checks whether prompt is in the library
          */
-        PromptTemplatePipelineLibrary.prototype.isPromptInLibrary = function (prompt) {
+        PromptbookLibrary.prototype.isPromptInLibrary = function (prompt) {
             return true;
         };
         /**
-         * Gets executor function for given prompt template pipeline
+         * Gets executor function for given promptbook
          */
-        PromptTemplatePipelineLibrary.prototype.createExecutor = function (name, tools) {
-            var ptp = this.getPtp(name);
-            return createPtpExecutor({ ptp: ptp, tools: tools, settings: this.options.settings });
+        PromptbookLibrary.prototype.createExecutor = function (name, tools) {
+            var promptbook = this.getPromptbookByName(name);
+            return createPromptbookExecutor({ promptbook: promptbook, tools: tools, settings: this.options.settings });
         };
-        return PromptTemplatePipelineLibrary;
+        return PromptbookLibrary;
     }());
     /**
-     * TODO: !!! This should be renamed to Promptbook
-     * TODO: !! [👐][🧠] Split of PromptTemplatePipeline,PromptTemplatePipelineLibrary between interface and class
-     * TODO: !! [👐] Make promptTemplatePipelines private WHEN split between interface and class
+     * TODO: [🈴] Identify promptbooks by url `promptbookUrls` + `getPromptbookByUrl`
+     * TODO: !! [👐][🧠] Split of Promptbook,PromptbookLibrary between interface and class
+     * TODO: !! [👐] Make promptbooks private WHEN split between interface and class
      * TODO: [🧠] Maybe isPromptInLibrary should be separate utility function
      * TODO: [🧠] Maybe createExecutor should be separate utility function
      * TODO: Static method fromDirectory
      * TODO: [🤜] Add generic type for entry and result parameters
-     * TODO: [🧠] Is it better to ptbkLibrary.executePtp('writeXyz',{...}) OR ptbkLibrary.createExecutor('writeXyz')({...}) OR createExecutor(ptbkLibrary.getPtp('writeXyz'))
-     * TODO: [🧠] Formarly (before commit 62229afce7668a5b85077cc18becf798b583bf8d) there were two classes PromptTemplatePipelineLibrary+PtpLibraryExecutor (maybe it was better?)
+     * TODO: [🧠] Is it better to promptbookLibrary.executePromptbook('writeXyz',{...}) OR promptbookLibrary.createExecutor('writeXyz')({...}) OR createExecutor(promptbookLibrary.getPromptbook('writeXyz'))
+     * TODO: [🧠] Formarly (before commit 62229afce7668a5b85077cc18becf798b583bf8d) there were two classes PromptbookLibrary+PromptbookLibraryExecutor (maybe it was better?)
      * TODO: [🧠] Is it better to pass tools into getExecutor or into constructor
      *             Maybe it is not a good idea to cache executors when they are can be created with different tools
      * TODO: [👧] Strongly type the executors to avoid need of remove nullables whtn noUncheckedIndexedAccess in tsconfig.json
@@ -1997,12 +2000,12 @@
     exports.CallbackInterfaceTools = CallbackInterfaceTools;
     exports.ExecutionTypes = ExecutionTypes;
     exports.MockedEchoNaturalExecutionTools = MockedEchoNaturalExecutionTools;
-    exports.PTBK_VERSION = PTBK_VERSION;
-    exports.PromptTemplatePipelineLibrary = PromptTemplatePipelineLibrary;
+    exports.PROMPTBOOK_VERSION = PROMPTBOOK_VERSION;
+    exports.PromptbookLibrary = PromptbookLibrary;
     exports.SimplePromptInterfaceTools = SimplePromptInterfaceTools;
-    exports.createPtpExecutor = createPtpExecutor;
-    exports.promptTemplatePipelineStringToJson = promptTemplatePipelineStringToJson;
-    exports.validatePromptTemplatePipelineJson = validatePromptTemplatePipelineJson;
+    exports.createPromptbookExecutor = createPromptbookExecutor;
+    exports.promptbookStringToJson = promptbookStringToJson;
+    exports.validatePromptbookJson = validatePromptbookJson;
 
     Object.defineProperty(exports, '__esModule', { value: true });