@promptbook/core 0.55.0 → 0.56.0-2

package/esm/typings/_packages/openai.index.d.ts

@@ -1,4 +1,6 @@
 import { OPENAI_MODELS } from '../execution/plugins/llm-execution-tools/openai/openai-models';
 import { OpenAiExecutionTools } from '../execution/plugins/llm-execution-tools/openai/OpenAiExecutionTools';
 import { OpenAiExecutionToolsOptions } from '../execution/plugins/llm-execution-tools/openai/OpenAiExecutionToolsOptions';
+import { PROMPTBOOK_VERSION } from '../version';
+export { PROMPTBOOK_VERSION };
 export { OPENAI_MODELS, OpenAiExecutionTools, OpenAiExecutionToolsOptions };

package/esm/typings/_packages/remote-client.index.d.ts

@@ -1,4 +1,6 @@
 import { RemoteServerOptions } from '../execution/plugins/llm-execution-tools/remote/interfaces/RemoteServerOptions';
 import { RemoteLlmExecutionTools } from '../execution/plugins/llm-execution-tools/remote/RemoteLlmExecutionTools';
 import { RemoteLlmExecutionToolsOptions } from '../execution/plugins/llm-execution-tools/remote/RemoteLlmExecutionToolsOptions';
+import { PROMPTBOOK_VERSION } from '../version';
+export { PROMPTBOOK_VERSION };
 export { RemoteLlmExecutionTools, RemoteLlmExecutionToolsOptions, RemoteServerOptions };

package/esm/typings/_packages/remote-server.index.d.ts

@@ -1,3 +1,5 @@
 import { RemoteServerOptions } from '../execution/plugins/llm-execution-tools/remote/interfaces/RemoteServerOptions';
 import { startRemoteServer } from '../execution/plugins/llm-execution-tools/remote/startRemoteServer';
+import { PROMPTBOOK_VERSION } from '../version';
+export { PROMPTBOOK_VERSION };
 export { RemoteServerOptions, startRemoteServer };

package/esm/typings/_packages/types.index.d.ts

@@ -20,8 +20,9 @@ import type { TaskProgress } from '../types/TaskProgress';
 import type { ExecutionReportJson } from '../types/execution-report/ExecutionReportJson';
 import type { string_char_emoji } from '../types/typeAliasEmoji';
 import type { client_id, string_char, string_chat_prompt, string_completion_prompt, string_data_url, string_domain, string_email, string_file_absolute_path, string_file_extension, string_file_path, string_file_relative_path, string_filename, string_folder_absolute_path, string_folder_path, string_folder_relative_path, string_host, string_hostname, string_href, string_html, string_javascript, string_javascript_name, string_license, string_markdown, string_markdown_text, string_mime_type, string_mime_type_with_wildcard, string_model_name, string_name, string_person_fullname, string_prompt, string_promptbook_url, string_promptbook_url_with_hashtemplate, string_script, string_sha256, string_tdl, string_template, string_text_prompt, string_title, string_token, string_translate_language, string_uri, string_uri_part, string_url, string_url_image, string_version } from '../types/typeAliases';
-import { FromtoItems } from '../utils/FromtoItems';
-export { AvailableModel, client_id, CommonExecutionToolsOptions, ExecutionReportJson, ExecutionTools, ExecutionType, EXPECTATION_UNITS, ExpectationAmount, Expectations, ExpectationUnit, FromtoItems, LlmExecutionTools, LlmTemplateJson, ModelRequirements, ModelVariant, Parameters, Prompt, PromptbookExecutor, PromptbookJson, PromptbookLibrary, PromptbookString, PromptChatResult, PromptCommonResult, PromptCompletionResult, PromptDialogJson, PromptResult, PromptResultUsage, PromptResultUsageCounts, PromptTemplateJson, PromptTemplateParameterJson, ScriptExecutionTools, ScriptExecutionToolsExecuteOptions, ScriptJson, ScriptLanguage, SimpleTemplateJson, string_char, string_char_emoji, string_chat_prompt, string_completion_prompt, string_data_url, string_domain, string_email, string_file_absolute_path, string_file_extension, string_file_path, string_file_relative_path, string_filename, string_folder_absolute_path, string_folder_path, string_folder_relative_path, string_host, string_hostname, string_href, string_html, string_javascript, string_javascript_name, string_license, string_markdown, string_markdown_text, string_mime_type, string_mime_type_with_wildcard, string_model_name, string_name, string_person_fullname, string_prompt, string_promptbook_url, string_promptbook_url_with_hashtemplate, string_script, string_sha256, string_tdl, string_template, string_text_prompt, string_title, string_token, string_translate_language, string_uri, string_uri_part, string_url, string_url_image, string_version, TaskProgress, UncertainNumber, UserInterfaceTools, UserInterfaceToolsPromptDialogOptions, };
+import type { FromtoItems } from '../utils/FromtoItems';
+import { PROMPTBOOK_VERSION } from '../version';
+export type { AvailableModel, client_id, CommonExecutionToolsOptions, ExecutionReportJson, ExecutionTools, ExecutionType, EXPECTATION_UNITS, ExpectationAmount, Expectations, ExpectationUnit, FromtoItems, LlmExecutionTools, LlmTemplateJson, ModelRequirements, ModelVariant, Parameters, Prompt, PROMPTBOOK_VERSION, PromptbookExecutor, PromptbookJson, PromptbookLibrary, PromptbookString, PromptChatResult, PromptCommonResult, PromptCompletionResult, PromptDialogJson, PromptResult, PromptResultUsage, PromptResultUsageCounts, PromptTemplateJson, PromptTemplateParameterJson, ScriptExecutionTools, ScriptExecutionToolsExecuteOptions, ScriptJson, ScriptLanguage, SimpleTemplateJson, string_char, string_char_emoji, string_chat_prompt, string_completion_prompt, string_data_url, string_domain, string_email, string_file_absolute_path, string_file_extension, string_file_path, string_file_relative_path, string_filename, string_folder_absolute_path, string_folder_path, string_folder_relative_path, string_host, string_hostname, string_href, string_html, string_javascript, string_javascript_name, string_license, string_markdown, string_markdown_text, string_mime_type, string_mime_type_with_wildcard, string_model_name, string_name, string_person_fullname, string_prompt, string_promptbook_url, string_promptbook_url_with_hashtemplate, string_script, string_sha256, string_tdl, string_template, string_text_prompt, string_title, string_token, string_translate_language, string_uri, string_uri_part, string_url, string_url_image, string_version, TaskProgress, UncertainNumber, UserInterfaceTools, UserInterfaceToolsPromptDialogOptions, };
 /**
  * TODO: Delete type aliases (from ../types/typeAliases) that are not exported here
  */

package/esm/typings/_packages/utils.index.d.ts

@@ -47,7 +47,8 @@ import { union } from '../utils/sets/union';
 import { trimCodeBlock } from '../utils/trimCodeBlock';
 import { trimEndOfCodeBlock } from '../utils/trimEndOfCodeBlock';
 import { unwrapResult } from '../utils/unwrapResult';
-export { forEachAsync };
+import { PROMPTBOOK_VERSION } from '../version';
+export { forEachAsync, PROMPTBOOK_VERSION };
 export { extractAllBlocksFromMarkdown, // <- [🌻]
 extractAllListItemsFromMarkdown, extractBlock, // <- [🌻]
 extractOneBlockFromMarkdown, extractParameters, extractVariables, isValidJsonString, parseNumber, // <- [🌻]

package/esm/typings/execution/plugins/llm-execution-tools/mocked/fakeTextToExpectations.d.ts

@@ -10,6 +10,5 @@ import type { PostprocessingFunction } from '../../script-execution-tools/javasc
  */
 export declare function $fakeTextToExpectations(expectations: Expectations, postprocessing?: Array<PostprocessingFunction>): Promise<string>;
 /**
- * TODO: [🚏] Implement better - create FakeLLM from this
  * TODO: [💝] Unite object for expecting amount and format - use here also a format
  */

package/esm/typings/library/constructors/createPromptbookLibraryFromDirectory.d.ts

@@ -41,13 +41,3 @@ type CreatePromptbookLibraryFromDirectoryOptions = {
  */
 export declare function createPromptbookLibraryFromDirectory(path: string_folder_path, options?: CreatePromptbookLibraryFromDirectoryOptions): Promise<PromptbookLibrary>;
 export {};
-/***
- * 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
- */

package/esm/typings/library/constructors/createPromptbookLibraryFromPromise.d.ts

@@ -21,6 +21,3 @@ import type { PromptbookLibrary } from '../PromptbookLibrary';
  * @private Just internal tool for other constructor functions
  */
 export declare function createPromptbookLibraryFromPromise(promptbookSourcesPromiseOrFactory: Promise<Array<PromptbookJson | PromptbookString>> | (() => Promise<Array<PromptbookJson | PromptbookString>>)): PromptbookLibrary;
-/***
- * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
- */

package/esm/typings/library/constructors/createPromptbookLibraryFromSources.d.ts

@@ -11,6 +11,3 @@ import { SimplePromptbookLibrary } from '../SimplePromptbookLibrary';
  * @returns PromptbookLibrary
  */
 export declare function createPromptbookLibraryFromSources(...promptbookSources: Array<PromptbookJson | PromptbookString>): SimplePromptbookLibrary;
-/***
- * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
- */

package/esm/typings/library/constructors/createPromptbookLibraryFromUrl.d.ts

@@ -24,7 +24,3 @@ type CreatePromptbookLibraryFromUrlyOptions = {
  */
 export declare function createPromptbookLibraryFromUrl(url: string_url | URL, options: CreatePromptbookLibraryFromUrlyOptions): Promise<PromptbookLibrary>;
 export {};
-/***
- * TODO: [⚖] Compatible with remote server
- * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
- */

package/esm/typings/library/constructors/createPromptbookSublibrary.d.ts

@@ -10,6 +10,3 @@ import type { PromptbookLibrary } from '../PromptbookLibrary';
  * @returns PromptbookLibrary
  */
 export declare function createPromptbookSublibrary(library: PromptbookLibrary, predicate: (url: string_promptbook_url) => boolean): PromptbookLibrary;
-/***
- * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
- */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/core",
-    "version": "0.55.0",
+    "version": "0.56.0-2",
     "description": "Library to supercharge your use of large language models",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('prettier'), require('prettier/parser-html'), require('path'), require('moment')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'prettier', 'prettier/parser-html', 'path', 'moment'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.spaceTrim, global.prettier, global.parserHtml, global.path, global.moment));
-})(this, (function (exports, spaceTrim, prettier, parserHtml, path, moment) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('prettier'), require('prettier/parser-html'), require('moment')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'prettier', 'prettier/parser-html', 'moment'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-core"] = {}, global.spaceTrim, global.prettier, global.parserHtml, global.moment));
+})(this, (function (exports, spaceTrim, prettier, parserHtml, moment) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -454,7 +454,7 @@
     /**
      * The version of the Promptbook library
      */
-    var PROMPTBOOK_VERSION = '0.55.0-2';
+    var PROMPTBOOK_VERSION = '0.56.0-1';
 
     /**
      * Parses the template and returns the list of all parameter names
@@ -3349,36 +3349,6 @@
         return uncertainNumber;
     }
 
-    /**
-     * Detects if the code is running in a browser environment in main thread (Not in a web worker)
-     */
-    new Function("\n    try {\n        return this === window;\n    } catch (e) {\n        return false;\n    }\n");
-    /**
-     * Detects if the code is running in a Node.js environment
-     */
-    var isRunningInNode = new Function("\n    try {\n        return this === global;\n    } catch (e) {\n        return false;\n    }\n");
-    /**
-     * Detects if the code is running in a web worker
-     */
-    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;
-    }
-
     /**
      * Library of promptbooks that groups together promptbooks for an application.
      * This implementation is a very thin wrapper around the Array / Map of promptbooks.
@@ -3498,9 +3468,6 @@
         }
         return new (SimplePromptbookLibrary.bind.apply(SimplePromptbookLibrary, __spreadArray([void 0], __read(promptbooks), false)))();
     }
-    /***
-     * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
-     */
 
     /**
      * Constructs Promptbook from async sources
@@ -3584,226 +3551,6 @@
             isResponsibleForPrompt: isResponsibleForPrompt,
         };
     }
-    /***
-     * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
-     */
-
-    /**
-     * Constructs Promptbook from given directory
-     *
-     * Note: Works only in Node.js environment because it reads the file system
-     *
-     * @param path - path to the directory with promptbooks
-     * @param options - Misc options for the library
-     * @returns PromptbookLibrary
-     */
-    function createPromptbookLibraryFromDirectory(path, options) {
-        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__default["default"](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$1, 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$1, {
-                                withFileTypes: true /* Note: This is not working: recursive: isRecursive */,
-                            })];
-                    case 1:
-                        dirents = _h.sent();
-                        fileNames = dirents.filter(function (dirent) { return dirent.isFile(); }).map(function (_a) {
-                            var name = _a.name;
-                            return path.join(path$1, name);
-                        });
-                        if (!isRecursive) return [3 /*break*/, 9];
-                        _h.label = 2;
-                    case 2:
-                        _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 = path.join(path$1, 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
@@ -3836,10 +3583,6 @@
             });
         });
     }
-    /***
-     * TODO: [⚖] Compatible with remote server
-     * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
-     */
 
     /**
      * Creates PromptbookLibrary as a subset of another PromptbookLibrary
@@ -3919,9 +3662,36 @@
             isResponsibleForPrompt: isResponsibleForPrompt,
         };
     }
-    /***
-     * TODO: [🍓][🚯] !!! Add to README and samples + maybe make `@promptbook/library` package
+
+    /**
+     * Detects if the code is running in a browser environment in main thread (Not in a web worker)
+     */
+    new Function("\n    try {\n        return this === window;\n    } catch (e) {\n        return false;\n    }\n");
+    /**
+     * Detects if the code is running in a Node.js environment
      */
+    var isRunningInNode = new Function("\n    try {\n        return this === global;\n    } catch (e) {\n        return false;\n    }\n");
+    /**
+     * Detects if the code is running in a web worker
+     */
+    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;
+    }
 
     /**
      * Just testing imports and compatibility
@@ -4271,7 +4041,6 @@
     exports.assertsExecutionSuccessful = assertsExecutionSuccessful;
     exports.checkExpectations = checkExpectations;
     exports.createPromptbookExecutor = createPromptbookExecutor;
-    exports.createPromptbookLibraryFromDirectory = createPromptbookLibraryFromDirectory;
     exports.createPromptbookLibraryFromSources = createPromptbookLibraryFromSources;
     exports.createPromptbookLibraryFromUrl = createPromptbookLibraryFromUrl;
     exports.createPromptbookSublibrary = createPromptbookSublibrary;