@promptbook/core 0.52.0-9 → 0.52.0

package/README.md

@@ -11,7 +11,6 @@ Library to supercharge your use of large language models
 [![Issues](https://img.shields.io/github/issues/webgptorg/promptbook.svg?style=flat)](https://github.com/webgptorg/promptbook/issues)
 
 
-[![Socket Badge](https://socket.dev/api/badge/npm/package/@promptbook/core)](https://socket.dev/npm/package/@promptbook/core)
 
 
 
@@ -75,15 +74,6 @@ In any of these situations, but especially in (3), the Promptbook library can ma
 -   _(Not ready yet)_ Leverage the **streaming** to make super cool UI/UX.
 -   _(Not ready yet)_ **A/B testing** to determine which prompt works best for the job.
 
-![WebGPT](./other/screencasts/screencast-fiabciakcmgepblmdkmemdbbkilneeeh-2023.10.26-21_46_17.gif)
-
-## 🧔 Promptbook _(for prompt-engeneers)_
-
-**P**romp**t** **b**oo**k** markdown file (**PTBK** for short, or `.ptbk.md`) is document that describes a series of prompts that are chained together to form somewhat reciepe for transforming natural language input. Inside a PTBK you can use chat prompts, completion prompts, scripting or trigger interaction with user to ask for additional information.
-
--   Multiple promptbooks forms a library which will become a **part of your application codebase**.
--   Theese promptbooks are designed such as they **can be written by non-programmers**.
-
 
 
 ### Sample:
@@ -96,7 +86,7 @@ File `write-website-content.ptbk.md`:
 >
 > Instructions for creating web page content.
 >
-> -   PROMPTBOOK URL https://promptbook.webgpt.com/en/write-website-content.ptbk.md@v0.1.0
+> -   PROMPTBOOK URL https://promptbook.webgpt.com/en/write-website-content.ptbk.md
 > -   PROMPTBOOK VERSION 0.0.1
 > -   INPUT  PARAM `{rawTitle}` Automatically suggested a site name or empty text
 > -   INPUT  PARAM `{rawAssigment}` Automatically generated site entry from image recognition
@@ -555,8 +545,6 @@ _Note: LLMs work with tokens, not characters, but in Promptbooks we want to use
 ```markdown
 # ✨ Sample: Expectations
 
--   PROMPTBOOK URL https://promptbook.example.com/samples/postprocessing-2.ptbk.md@v1
--   PROMPTBOOK VERSION 1.0.0
 -   INPUT  PARAMETER {yourName} Name of the hero
 
 ## 💬 Question

package/esm/index.es.js

@@ -1,6 +1,7 @@
 import spaceTrim$1, { spaceTrim } from 'spacetrim';
 import { format } from 'prettier';
 import parserHtml from 'prettier/parser-html';
+import { join } from 'path';
 import moment from 'moment';
 
 /*! *****************************************************************************
@@ -447,7 +448,7 @@ function union() {
 /**
  * The version of the Promptbook library
  */
-var PROMPTBOOK_VERSION = '0.52.0-8';
+var PROMPTBOOK_VERSION = '0.52.0-33';
 
 /**
  * Parses the template and returns the list of all parameter names
@@ -1824,6 +1825,9 @@ function promptbookStringToJson(promptbookString) {
             postprocessing = undefined;
         }
         dependentParameterNames = union(dependentParameterNames, extractParametersFromPromptTemplate(__assign(__assign({}, section), { description: description_1, executionType: executionType, content: content })));
+        if (templateModelRequirements.modelVariant === undefined) {
+            templateModelRequirements.modelVariant = 'CHAT';
+        }
         promptbookJson.promptTemplates.push({
             name: titleToName(section.title),
             title: section.title,
@@ -2169,6 +2173,7 @@ function isValidUrl(url) {
  * @throws {PromptbookLogicError} on logical error in the promptbook
  */
 function validatePromptbookJson(promptbook) {
+    // 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 (promptbook.promptbookUrl !== undefined) {
         if (!isValidUrl(promptbook.promptbookUrl)) {
@@ -2176,6 +2181,16 @@ function validatePromptbookJson(promptbook) {
             throw new PromptbookLogicError("Invalid promptbook URL \"".concat(promptbook.promptbookUrl, "\""));
         }
     }
+    // TODO: [🧠] Maybe do here some propper JSON-schema / ZOD checking
+    if (!Array.isArray(promptbook.parameters)) {
+        // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
+        throw new PromptbookSyntaxError(spaceTrim("\n                Promptbook is valid JSON but with wrong structure\n\n                promptbook.parameters expected to be an array, but got ".concat(typeof promptbook.parameters, "\n            ")));
+    }
+    // TODO: [🧠] Maybe do here some propper JSON-schema / ZOD checking
+    if (!Array.isArray(promptbook.promptTemplates)) {
+        // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
+        throw new PromptbookSyntaxError(spaceTrim("\n              Promptbook is valid JSON but with wrong structure\n\n              promptbook.promptTemplates expected to be an array, but got ".concat(typeof promptbook.promptTemplates, "\n          ")));
+    }
     var _loop_1 = function (parameter) {
         if (parameter.isInput && parameter.isOutput) {
             throw new PromptbookLogicError("Parameter {".concat(parameter.name, "} can not be both input and output"));
@@ -2222,9 +2237,8 @@ function validatePromptbookJson(promptbook) {
             }
             definedParameters.add(template.resultingParameterName);
             if (template.executionType === 'PROMPT_TEMPLATE' &&
-                (template.modelRequirements.modelVariant === undefined ||
-                    template.modelRequirements.modelName === undefined)) {
-                throw new PromptbookLogicError(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              ")));
+                (template.modelRequirements.modelVariant === undefined)) {
+                throw new PromptbookLogicError(spaceTrim("\n\n                  You must specify MODEL VARIANT 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 &&
@@ -2525,7 +2539,7 @@ function createPromptbookExecutor(options) {
                                 title: currentTemplate.title,
                                 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),
+                                    : 'anonymous' /* <- TODO: [🧠] 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,
@@ -3155,6 +3169,20 @@ var SimplePromptInterfaceTools = /** @class */ (function () {
     return SimplePromptInterfaceTools;
 }());
 
+/**
+ * This error indicates that the promptbook library cannot be propperly loaded
+ */
+var PromptbookLibraryError = /** @class */ (function (_super) {
+    __extends(PromptbookLibraryError, _super);
+    function PromptbookLibraryError(message) {
+        var _this = _super.call(this, message) || this;
+        _this.name = 'PromptbookLibraryError';
+        Object.setPrototypeOf(_this, PromptbookLibraryError.prototype);
+        return _this;
+    }
+    return PromptbookLibraryError;
+}(Error));
+
 /**
  * Detects if the code is running in a browser environment in main thread (Not in a web worker)
  */
@@ -3168,6 +3196,23 @@ var isRunningInNode = new Function("\n    try {\n        return this === global;
  */
 new Function("\n    try {\n        if (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) {\n            return true;\n        } else {\n            return false;\n        }\n    } catch (e) {\n        return false;\n    }\n");
 
+/**
+ * Returns the same value that is passed as argument.
+ * No side effects.
+ *
+ * Note: It can be usefull for leveling indentation
+ *
+ * @param value any values
+ * @returns the same values
+ */
+function just(value) {
+    if (value === undefined) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return undefined;
+    }
+    return value;
+}
+
 /**
  * This error indicates that promptbook not found in the library
  */
@@ -3225,6 +3270,12 @@ var SimplePromptbookLibrary = /** @class */ (function () {
                     throw new PromptbookReferenceError(spaceTrim("\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                    ")));
                 }
                 validatePromptbookJson(promptbook);
+                // Note: [🦄]
+                if (this.library.has(promptbook.promptbookUrl) &&
+                    promptbookJsonToString(promptbook) !==
+                        promptbookJsonToString(this.library.get(promptbook.promptbookUrl))) {
+                    throw new PromptbookReferenceError(spaceTrim("\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);
             }
         }
@@ -3251,6 +3302,9 @@ var SimplePromptbookLibrary = /** @class */ (function () {
         var _this = this;
         var promptbook = this.library.get(url);
         if (!promptbook) {
+            if (this.listPromptbooks().length === 0) {
+                throw new PromptbookNotFoundError(spaceTrim("\n                            Promptbook with url \"".concat(url, "\" not found\n\n                            No promptbooks available\n                        ")));
+            }
             throw new PromptbookNotFoundError(spaceTrim(function (block) { return "\n                        Promptbook with url \"".concat(url, "\" not found\n\n                        Available promptbooks:\n                        ").concat(block(_this.listPromptbooks()
                 .map(function (promptbookUrl) { return "- ".concat(promptbookUrl); })
                 .join('\n')), "\n\n                    "); }));
@@ -3323,11 +3377,11 @@ function createPromptbookLibraryFromSources() {
  * 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 `listPromptbooks` or `getPromptbookByUrl` call
  *
+ * Note: Consider using  `createPromptbookLibraryFromDirectory` or `createPromptbookLibraryFromUrl`
  *
  * @param promptbookSourcesPromiseOrFactory
  * @returns PromptbookLibrary
- *
- * @deprecated Consider using `createPromptbookLibraryFromUrl` or `createPromptbookLibraryFromDirectory`
+ * @private Just internal tool for other constructor functions
  */
 function createPromptbookLibraryFromPromise(promptbookSourcesPromiseOrFactory) {
     var library;
@@ -3400,37 +3454,252 @@ function createPromptbookLibraryFromPromise(promptbookSourcesPromiseOrFactory) {
  * Constructs Promptbook from given directory
  *
  * Note: Works only in Node.js environment because it reads the file system
- * Note: The function does NOT return promise it returns the library directly which dynamically loads promptbooks when needed
- *       SO during the construction syntax and logic sources IS NOT validated
  *
  * @param path - path to the directory with promptbooks
  * @param options - Misc options for the library
  * @returns PromptbookLibrary
  */
 function createPromptbookLibraryFromDirectory(path, options) {
-    var _this = this;
-    if (!isRunningInNode()) {
-        throw new Error('Function `createPromptbookLibraryFromDirectory` can only be run in Node.js environment because it reads the file system.');
-    }
-    var _a = (options || {}).isRecursive, isRecursive = _a === void 0 ? true : _a;
-    return createPromptbookLibraryFromPromise(function () { return __awaiter(_this, void 0, void 0, function () {
-        var readdir, readdirResult;
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0: return [4 /*yield*/, import('fs/promises')];
+    return __awaiter(this, void 0, void 0, function () {
+        var _a, _b, isRecursive, _c, isVerbose, _d, isLazyLoaded, _e, isCrashOnError, library;
+        var _this = this;
+        return __generator(this, function (_f) {
+            switch (_f.label) {
+                case 0:
+                    if (!isRunningInNode()) {
+                        throw new Error('Function `createPromptbookLibraryFromDirectory` can only be run in Node.js environment because it reads the file system.');
+                    }
+                    _a = options || {}, _b = _a.isRecursive, isRecursive = _b === void 0 ? true : _b, _c = _a.isVerbose, isVerbose = _c === void 0 ? false : _c, _d = _a.isLazyLoaded, isLazyLoaded = _d === void 0 ? false : _d, _e = _a.isCrashOnError, isCrashOnError = _e === void 0 ? true : _e;
+                    library = createPromptbookLibraryFromPromise(function () { return __awaiter(_this, void 0, void 0, function () {
+                        var fsPromises, readFile, fileNames, promptbooks, _loop_1, fileNames_1, fileNames_1_1, fileName, e_1_1;
+                        var e_1, _a;
+                        return __generator(this, function (_b) {
+                            switch (_b.label) {
+                                case 0:
+                                    if (isVerbose) {
+                                        console.info("Creating promptbook library from path ".concat(path));
+                                    }
+                                    fsPromises = require(just('fs/promises') /* <- Note: [1] */);
+                                    readFile = fsPromises.readFile;
+                                    return [4 /*yield*/, listAllFiles(path, isRecursive)];
+                                case 1:
+                                    fileNames = _b.sent();
+                                    if (isVerbose) {
+                                        console.info('createPromptbookLibraryFromDirectory', { path: path, isRecursive: isRecursive, fileNames: fileNames });
+                                    }
+                                    promptbooks = [];
+                                    _loop_1 = function (fileName) {
+                                        var promptbook, promptbookString, _c, _d, error_1, wrappedErrorMessage;
+                                        return __generator(this, function (_e) {
+                                            switch (_e.label) {
+                                                case 0:
+                                                    _e.trys.push([0, 6, , 7]);
+                                                    promptbook = null;
+                                                    if (!fileName.endsWith('.ptbk.md')) return [3 /*break*/, 2];
+                                                    return [4 /*yield*/, readFile(fileName, 'utf8')];
+                                                case 1:
+                                                    promptbookString = (_e.sent());
+                                                    promptbook = promptbookStringToJson(promptbookString);
+                                                    return [3 /*break*/, 5];
+                                                case 2:
+                                                    if (!fileName.endsWith('.ptbk.json')) return [3 /*break*/, 4];
+                                                    if (isVerbose) {
+                                                        console.info("Loading ".concat(fileName));
+                                                    }
+                                                    _d = (_c = JSON).parse;
+                                                    return [4 /*yield*/, readFile(fileName, 'utf8')];
+                                                case 3:
+                                                    // TODO: Handle non-valid JSON files
+                                                    promptbook = _d.apply(_c, [_e.sent()]);
+                                                    return [3 /*break*/, 5];
+                                                case 4:
+                                                    if (isVerbose) {
+                                                        console.info("Skipping file ".concat(fileName));
+                                                    }
+                                                    _e.label = 5;
+                                                case 5:
+                                                    // ---
+                                                    if (promptbook !== null) {
+                                                        if (!promptbook.promptbookUrl) {
+                                                            if (isVerbose) {
+                                                                console.info("Not loading ".concat(fileName, " - missing URL"));
+                                                            }
+                                                        }
+                                                        else {
+                                                            if (isVerbose) {
+                                                                console.info("Loading ".concat(fileName));
+                                                            }
+                                                            if (!isCrashOnError) {
+                                                                // Note: Validate promptbook to check if it is logically correct to not crash on invalid promptbooks
+                                                                //       But be handled in current try-catch block
+                                                                validatePromptbookJson(promptbook);
+                                                            }
+                                                            // Note: [🦄] Promptbook with same url uniqueness will be checked automatically in SimplePromptbookLibrary
+                                                            promptbooks.push(promptbook);
+                                                        }
+                                                    }
+                                                    return [3 /*break*/, 7];
+                                                case 6:
+                                                    error_1 = _e.sent();
+                                                    if (!(error_1 instanceof Error)) {
+                                                        throw error_1;
+                                                    }
+                                                    wrappedErrorMessage = spaceTrim$1(function (block) { return "\n                        Error during loading promptbook from file ".concat(fileName.split('\\').join('/'), ":\n\n                        ").concat(block(error_1.message), "\n\n                    "); });
+                                                    if (isCrashOnError) {
+                                                        throw new PromptbookLibraryError(wrappedErrorMessage);
+                                                    }
+                                                    console.error(wrappedErrorMessage);
+                                                    return [3 /*break*/, 7];
+                                                case 7: return [2 /*return*/];
+                                            }
+                                        });
+                                    };
+                                    _b.label = 2;
+                                case 2:
+                                    _b.trys.push([2, 7, 8, 9]);
+                                    fileNames_1 = __values(fileNames), fileNames_1_1 = fileNames_1.next();
+                                    _b.label = 3;
+                                case 3:
+                                    if (!!fileNames_1_1.done) return [3 /*break*/, 6];
+                                    fileName = fileNames_1_1.value;
+                                    return [5 /*yield**/, _loop_1(fileName)];
+                                case 4:
+                                    _b.sent();
+                                    _b.label = 5;
+                                case 5:
+                                    fileNames_1_1 = fileNames_1.next();
+                                    return [3 /*break*/, 3];
+                                case 6: return [3 /*break*/, 9];
+                                case 7:
+                                    e_1_1 = _b.sent();
+                                    e_1 = { error: e_1_1 };
+                                    return [3 /*break*/, 9];
+                                case 8:
+                                    try {
+                                        if (fileNames_1_1 && !fileNames_1_1.done && (_a = fileNames_1.return)) _a.call(fileNames_1);
+                                    }
+                                    finally { if (e_1) throw e_1.error; }
+                                    return [7 /*endfinally*/];
+                                case 9: return [2 /*return*/, promptbooks];
+                            }
+                        });
+                    }); });
+                    if (!(isLazyLoaded === false)) return [3 /*break*/, 2];
+                    return [4 /*yield*/, library.listPromptbooks()];
+                case 1:
+                    _f.sent();
+                    _f.label = 2;
+                case 2: return [2 /*return*/, library];
+            }
+        });
+    });
+}
+/**
+ * Reads all files in the directory
+ *
+ * @param path
+ * @param isRecursive
+ * @returns List of all files in the directory
+ * @private internal function for `createPromptbookLibraryFromDirectory`
+ */
+function listAllFiles(path, isRecursive) {
+    return __awaiter(this, void 0, void 0, function () {
+        var fsPromises, readdir, dirents, fileNames, _a, _b, dirent, subPath, _c, _d, _e, _f, e_2_1;
+        var e_2, _g;
+        return __generator(this, function (_h) {
+            switch (_h.label) {
+                case 0:
+                    fsPromises = require(just('fs/promises') /* <- Note: [1] */);
+                    readdir = fsPromises.readdir;
+                    return [4 /*yield*/, readdir(path, {
+                            withFileTypes: true /* Note: This is not working: recursive: isRecursive */,
+                        })];
                 case 1:
-                    readdir = (_a.sent()).readdir;
-                    return [4 /*yield*/, readdir(path)];
+                    dirents = _h.sent();
+                    fileNames = dirents.filter(function (dirent) { return dirent.isFile(); }).map(function (_a) {
+                        var name = _a.name;
+                        return join(path, name);
+                    });
+                    if (!isRecursive) return [3 /*break*/, 9];
+                    _h.label = 2;
                 case 2:
-                    readdirResult = _a.sent();
-                    // TODO: !!! Implement
-                    console.info('createPromptbookLibraryFromDirectory', { path: path, isRecursive: isRecursive, readdirResult: readdirResult });
-                    throw new Error('Not implemented yet');
+                    _h.trys.push([2, 7, 8, 9]);
+                    _a = __values(dirents.filter(function (dirent) { return dirent.isDirectory(); })), _b = _a.next();
+                    _h.label = 3;
+                case 3:
+                    if (!!_b.done) return [3 /*break*/, 6];
+                    dirent = _b.value;
+                    subPath = join(path, dirent.name);
+                    _d = (_c = fileNames.push).apply;
+                    _e = [fileNames];
+                    _f = [[]];
+                    return [4 /*yield*/, listAllFiles(subPath, isRecursive)];
+                case 4:
+                    _d.apply(_c, _e.concat([__spreadArray.apply(void 0, _f.concat([__read.apply(void 0, [(_h.sent())]), false]))]));
+                    _h.label = 5;
+                case 5:
+                    _b = _a.next();
+                    return [3 /*break*/, 3];
+                case 6: return [3 /*break*/, 9];
+                case 7:
+                    e_2_1 = _h.sent();
+                    e_2 = { error: e_2_1 };
+                    return [3 /*break*/, 9];
+                case 8:
+                    try {
+                        if (_b && !_b.done && (_g = _a.return)) _g.call(_a);
+                    }
+                    finally { if (e_2) throw e_2.error; }
+                    return [7 /*endfinally*/];
+                case 9: return [2 /*return*/, fileNames];
             }
         });
-    }); });
+    });
 }
 /***
+ * TODO: [🧠] Maybe do not do hacks like [1] and just create package @promptbook/node
+ *       [🍓][🚯] maybe make `@promptbook/library` package
+ * TODO: Fix the dynamic import issue in Webpack (! Not working !)
+ *     > ./node_modules/@promptbook/core/esm/index.es.js
+ *     > Critical dependency: the request of a dependency is an expression
+ *
+ * Note: [1] Using require(just('fs/promises')) to allow
+ *     the `@promptbook/core` work for both Node.js and browser environments
+ */
+
+/**
+ * Constructs Promptbook from remote Promptbase URL
+
+ * @returns PromptbookLibrary
+ */
+function createPromptbookLibraryFromUrl(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 = createPromptbookLibraryFromPromise(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.listPromptbooks()];
+                case 1:
+                    _d.sent();
+                    _d.label = 2;
+                case 2: return [2 /*return*/, library];
+            }
+        });
+    });
+}
+/***
+ * TODO: [⚖] Compatible with remote server
  * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
  */
 
@@ -3516,6 +3785,31 @@ function createPromptbookSublibrary(library, predicate) {
  * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
  */
 
+/**
+ * Just testing imports and compatibility
+ */
+function justTestFsImport() {
+    return __awaiter(this, void 0, void 0, function () {
+        var files;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!isRunningInNode()) {
+                        throw new Error('Function `testFiles` can only be run in Node.js environment because it reads the file system.');
+                    }
+                    return [4 /*yield*/, require(just('glob-promise'))('/**/*')];
+                case 1:
+                    files = _a.sent();
+                    console.info('testFiles', { files: files });
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * TODO: !!! Remove this file
+ */
+
 /**
  * Format either small or big number
  *
@@ -3536,23 +3830,6 @@ function formatNumber(value) {
     return value.toString();
 }
 
-/**
- * Returns the same value that is passed as argument.
- * No side effects.
- *
- * Note: It can be usefull for leveling indentation
- *
- * @param value any values
- * @returns the same values
- */
-function just(value) {
-    if (value === undefined) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return undefined;
-    }
-    return value;
-}
-
 /**
  * Create a markdown table from a 2D array of strings
  *
@@ -3833,5 +4110,5 @@ function executionReportJsonToString(executionReportJson, options) {
  * TODO: [🧠] Allow to filter out some parts of the report by options
  */
 
-export { CallbackInterfaceTools, ExecutionReportStringOptionsDefaults, ExecutionTypes, MultipleLlmExecutionTools, PROMPTBOOK_VERSION, SimplePromptInterfaceTools, SimplePromptbookLibrary, assertsExecutionSuccessful, checkExpectations, createPromptbookExecutor, createPromptbookLibraryFromDirectory, createPromptbookLibraryFromPromise, createPromptbookLibraryFromSources, createPromptbookSublibrary, executionReportJsonToString, isPassingExpectations, prettifyPromptbookString, promptbookJsonToString, promptbookStringToJson, validatePromptbookJson };
+export { CallbackInterfaceTools, ExecutionReportStringOptionsDefaults, ExecutionTypes, MultipleLlmExecutionTools, PROMPTBOOK_VERSION, SimplePromptInterfaceTools, SimplePromptbookLibrary, assertsExecutionSuccessful, checkExpectations, createPromptbookExecutor, createPromptbookLibraryFromDirectory, createPromptbookLibraryFromSources, createPromptbookLibraryFromUrl, createPromptbookSublibrary, executionReportJsonToString, isPassingExpectations, justTestFsImport, prettifyPromptbookString, promptbookJsonToString, promptbookStringToJson, validatePromptbookJson };
 //# sourceMappingURL=index.es.js.map