@promptbook/core 0.35.0 → 0.36.1

package/README.md

@@ -1,4 +1,4 @@
-# 📖 Prompt template pipelines
+# 📖 Promptbook
 
 Library to supercharge your use of large language models
 

package/esm/index.es.js

@@ -120,21 +120,6 @@ function __spreadArray(to, from, pack) {
     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
  */
@@ -435,6 +420,11 @@ function removeContentComments(content) {
     return spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
 }
 
+/**
+ * The version of the Promptbook library
+ */
+var PROMPTBOOK_VERSION = '0.36.0';
+
 /**
  * Execution type describes the way how the block is executed
  *
@@ -552,36 +542,39 @@ 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 !/^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("\n                        Invalid PTBK_URL command:\n\n                        - ".concat(listItem, "\n                    ")));
+            throw new Error(spaceTrim("\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("\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("\n                        Invalid PROMPTBOOK_URL command:\n\n                        - ".concat(listItem, "\n\n                        Protocol must be HTTPS\n                    ")));
         }
-        if (ptbkUrl.hash !== '') {
-            throw new Error(spaceTrim("\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("\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("\n                        Invalid PTBK_VERSION command:\n\n                        - ".concat(listItem, "\n                    ")));
+            throw new Error(spaceTrim("\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') ||
@@ -626,7 +619,7 @@ function parseCommand(listItem) {
             };
         }
         else {
-            throw new Error(spaceTrim(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(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') ||
@@ -752,41 +745,36 @@ function parseCommand(listItem) {
         }
     }
     else {
-        throw new Error(spaceTrim("\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("\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.34.1';
-
-/**
- * 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 &&
@@ -799,7 +787,7 @@ function promptTemplatePipelineStringToJson(promptTemplatePipelineString) {
             }
         }
         else {
-            ptbJson.parameters.push({
+            promptbookJson.parameters.push({
                 name: parameterName,
                 description: parameterDescription || undefined,
                 isInput: isInputParameter,
@@ -808,12 +796,12 @@ function promptTemplatePipelineStringToJson(promptTemplatePipelineString) {
     };
     // =============================================================
     // 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("\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
@@ -824,29 +812,28 @@ function promptTemplatePipelineStringToJson(promptTemplatePipelineString) {
     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"));
             }
         }
     }
@@ -886,7 +873,6 @@ function promptTemplatePipelineStringToJson(promptTemplatePipelineString) {
                         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':
@@ -920,7 +906,7 @@ function promptTemplatePipelineStringToJson(promptTemplatePipelineString) {
                         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"));
                 }
             }
         }
@@ -999,7 +985,7 @@ function promptTemplatePipelineStringToJson(promptTemplatePipelineString) {
             }
         }
         dependentParameterNames = __spreadArray([], __read(new Set(dependentParameterNames)), false);
-        ptbJson.promptTemplates.push({
+        promptbookJson.promptTemplates.push({
             name: normalizeTo_PascalCase(section.title),
             title: section.title,
             description: description_1,
@@ -1029,7 +1015,7 @@ function promptTemplatePipelineStringToJson(promptTemplatePipelineString) {
         finally { if (e_2) throw e_2.error; }
     }
     // =============================================================
-    return ptbJson;
+    return promptbookJson;
 }
 /**
  * TODO: Report here line/column of error
@@ -1038,7 +1024,7 @@ function promptTemplatePipelineStringToJson(promptTemplatePipelineString) {
  */
 
 /**
- * Validates PromptTemplatePipelineJson if it is logically valid.
+ * Validates PromptbookJson if it is logically valid.
  *
  * It checks:
  * -   if it has correct parameters dependency
@@ -1047,12 +1033,12 @@ function promptTemplatePipelineStringToJson(promptTemplatePipelineString) {
  * -   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) {
@@ -1061,11 +1047,16 @@ function validatePromptTemplatePipelineJson(ptp) {
     }));
     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("\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 */) {
@@ -1121,14 +1112,16 @@ function validatePromptTemplatePipelineJson(ptp) {
         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); });
@@ -1154,15 +1147,15 @@ function validatePromptTemplatePipelineJson(ptp) {
     }
 }
 /**
- * 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 {
  */
 
 /**
@@ -1319,16 +1312,16 @@ var ExpectError = /** @class */ (function (_super) {
  */
 
 /**
- * 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;
@@ -1336,9 +1329,9 @@ function createPtpExecutor(options) {
                 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,
@@ -1395,9 +1388,9 @@ function createPtpExecutor(options) {
                         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,
@@ -1654,7 +1647,7 @@ function createPtpExecutor(options) {
                                     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*/];
                     }
                 });
@@ -1666,17 +1659,17 @@ function createPtpExecutor(options) {
                 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;
@@ -1685,7 +1678,7 @@ function createPtpExecutor(options) {
                         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;
@@ -1749,50 +1742,50 @@ function createPtpExecutor(options) {
             }
         });
     }); };
-    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;
                 }
             }
@@ -1804,43 +1797,53 @@ var PromptTemplatePipelineLibrary = /** @class */ (function () {
             }
             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
@@ -1987,5 +1990,5 @@ var SimplePromptInterfaceTools = /** @class */ (function () {
     return SimplePromptInterfaceTools;
 }());
 
-export { CallbackInterfaceTools, ExecutionTypes, MockedEchoNaturalExecutionTools, PTBK_VERSION, PromptTemplatePipelineLibrary, SimplePromptInterfaceTools, createPtpExecutor, promptTemplatePipelineStringToJson, validatePromptTemplatePipelineJson };
+export { CallbackInterfaceTools, ExecutionTypes, MockedEchoNaturalExecutionTools, PROMPTBOOK_VERSION, PromptbookLibrary, SimplePromptInterfaceTools, createPromptbookExecutor, promptbookStringToJson, validatePromptbookJson };
 //# sourceMappingURL=index.es.js.map