@promptbook/remote-server 0.103.0-55 → 0.103.0-66

package/esm/index.es.js

@@ -1,7 +1,7 @@
 import { join, basename, dirname, isAbsolute } from 'path';
 import { spawn } from 'child_process';
 import colors from 'colors';
-import spaceTrim$1, { spaceTrim } from 'spacetrim';
+import spaceTrim$2, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import { forTime } from 'waitasecond';
 import express from 'express';
 import * as OpenApiValidator from 'express-openapi-validator';
@@ -33,12 +33,23 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-55';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-66';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * Trims string from all 4 sides
+ *
+ * Note: This is a re-exported function from the `spacetrim` package which is
+ *       Developed by same author @hejny as this package
+ *
+ * @public exported from `@promptbook/utils`
+ * @see https://github.com/hejny/spacetrim#usage
+ */
+const spaceTrim = spaceTrim$1;
+
 /**
  * @private util of `@promptbook/color`
  * @de
@@ -87,6 +98,7 @@ function take(initialValue) {
  * @public exported from `@promptbook/color`
  */
 const CSS_COLORS = {
+    promptbook: '#79EAFD',
     transparent: 'rgba(0,0,0,0)',
     aliceblue: '#f0f8ff',
     antiquewhite: '#faebd7',
@@ -287,21 +299,61 @@ class Color {
      * @param color
      * @returns Color object
      */
-    static from(color) {
-        if (color instanceof Color) {
+    static from(color, _isSingleValue = false) {
+        if (color === '') {
+            throw new Error(`Can not create color from empty string`);
+        }
+        else if (color instanceof Color) {
             return take(color);
         }
         else if (Color.isColor(color)) {
             return take(color);
         }
         else if (typeof color === 'string') {
-            return Color.fromString(color);
+            try {
+                return Color.fromString(color);
+            }
+            catch (error) {
+                // <- Note: Can not use `assertsError(error)` here because it causes circular dependency
+                if (_isSingleValue) {
+                    throw error;
+                }
+                const parts = color.split(/[\s+,;|]/);
+                if (parts.length > 0) {
+                    return Color.from(parts[0].trim(), true);
+                }
+                else {
+                    throw new Error(`Can not create color from given string "${color}"`);
+                }
+            }
         }
         else {
             console.error({ color });
             throw new Error(`Can not create color from given object`);
         }
     }
+    /**
+     * Creates a new Color instance from miscellaneous formats
+     * It just does not throw error when it fails, it returns PROMPTBOOK_COLOR instead
+     *
+     * @param color
+     * @returns Color object
+     */
+    static fromSafe(color) {
+        try {
+            return Color.from(color);
+        }
+        catch (error) {
+            // <- Note: Can not use `assertsError(error)` here because it causes circular dependency
+            console.warn(spaceTrim((block) => `
+                        Color.fromSafe error:
+                        ${block(error.message)}
+
+                        Returning default PROMPTBOOK_COLOR.
+                    `));
+            return Color.fromString('promptbook');
+        }
+    }
     /**
      * Creates a new Color instance from miscellaneous string formats
      *
@@ -919,7 +971,7 @@ const CLAIM = `Turn your company's scattered knowledge into AI ready books`;
  *
  * @public exported from `@promptbook/core`
  */
-const PROMPTBOOK_COLOR = Color.fromHex('#79EAFD');
+const PROMPTBOOK_COLOR = Color.fromString('promptbook');
 // <- TODO: [🧠][🈵] Using `Color` here increases the package size approx 3kb, maybe remove it
 /**
  * Colors for syntax highlighting in the `<BookEditor/>`
@@ -1266,11 +1318,11 @@ function $execCommand(options) {
                             console.warn(`Command "${humanReadableCommand}" exited with code ${code}`);
                             // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
                         }
-                        resolve(spaceTrim(output.join('\n')));
+                        resolve(spaceTrim$1(output.join('\n')));
                     }
                 }
                 else {
-                    resolve(spaceTrim(output.join('\n')));
+                    resolve(spaceTrim$1(output.join('\n')));
                 }
             };
             commandProcess.on('close', finishWithCode);
@@ -1288,7 +1340,7 @@ function $execCommand(options) {
                         console.warn(error);
                         // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
                     }
-                    resolve(spaceTrim(output.join('\n')));
+                    resolve(spaceTrim$1(output.join('\n')));
                 }
             });
         }
@@ -1339,7 +1391,7 @@ async function startAgentServer(options) {
 function getErrorReportUrl(error) {
     const report = {
         title: `🐜 Error report from ${NAME}`,
-        body: spaceTrim$1((block) => `
+        body: spaceTrim$2((block) => `
 
 
             \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
@@ -1382,7 +1434,7 @@ function getErrorReportUrl(error) {
  */
 class UnexpectedError extends Error {
     constructor(message) {
-        super(spaceTrim((block) => `
+        super(spaceTrim$1((block) => `
                     ${block(message)}
 
                     Note: This error should not happen.
@@ -1408,7 +1460,7 @@ class WrappedError extends Error {
     constructor(whatWasThrown) {
         const tag = `[🤮]`;
         console.error(tag, whatWasThrown);
-        super(spaceTrim(`
+        super(spaceTrim$1(`
                 Non-Error object was thrown
 
                 Note: Look for ${tag} in the console for more details
@@ -1604,7 +1656,7 @@ class LimitReachedError extends Error {
  */
 class MissingToolsError extends Error {
     constructor(message) {
-        super(spaceTrim((block) => `
+        super(spaceTrim$1((block) => `
                     ${block(message)}
 
                     Note: You have probably forgot to provide some tools for pipeline execution or preparation
@@ -1648,7 +1700,7 @@ class NotFoundError extends Error {
  */
 class NotYetImplementedError extends Error {
     constructor(message) {
-        super(spaceTrim((block) => `
+        super(spaceTrim$1((block) => `
                     ${block(message)}
 
                     Note: This feature is not implemented yet but it will be soon.
@@ -1792,7 +1844,7 @@ function serializeError(error) {
     const { name, message, stack } = error;
     const { id } = error;
     if (!Object.keys(ALL_ERRORS).includes(name)) {
-        console.error(spaceTrim$1((block) => `
+        console.error(spaceTrim$2((block) => `
 
                     Cannot serialize error with name "${name}"
 
@@ -2136,7 +2188,7 @@ function checkSerializableAsJson(options) {
     }
     else if (typeof value === 'object') {
         if (value instanceof Date) {
-            throw new UnexpectedError(spaceTrim$1((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         \`${name}\` is Date
 
                         Use \`string_date_iso8601\` instead
@@ -2155,7 +2207,7 @@ function checkSerializableAsJson(options) {
             throw new UnexpectedError(`${name} is RegExp`);
         }
         else if (value instanceof Error) {
-            throw new UnexpectedError(spaceTrim$1((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         \`${name}\` is unserialized Error
 
                         Use function \`serializeError\`
@@ -2178,7 +2230,7 @@ function checkSerializableAsJson(options) {
             }
             catch (error) {
                 assertsError(error);
-                throw new UnexpectedError(spaceTrim$1((block) => `
+                throw new UnexpectedError(spaceTrim$2((block) => `
                             \`${name}\` is not serializable
 
                             ${block(error.stack || error.message)}
@@ -2210,7 +2262,7 @@ function checkSerializableAsJson(options) {
         }
     }
     else {
-        throw new UnexpectedError(spaceTrim$1((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     \`${name}\` is unknown type
 
                     Additional message for \`${name}\`:
@@ -2481,7 +2533,7 @@ function validatePipeline(pipeline) {
             if (!(error instanceof PipelineLogicError)) {
                 throw error;
             }
-            console.error(spaceTrim((block) => `
+            console.error(spaceTrim$1((block) => `
                         Pipeline is not valid but logic errors are temporarily disabled via \`IS_PIPELINE_LOGIC_VALIDATED\`
 
                         ${block(error.message)}
@@ -2508,7 +2560,7 @@ function validatePipeline_InnerFunction(pipeline) {
     })();
     if (pipeline.pipelineUrl !== undefined && !isValidPipelineUrl(pipeline.pipelineUrl)) {
         // <- Note: [🚲]
-        throw new PipelineLogicError(spaceTrim((block) => `
+        throw new PipelineLogicError(spaceTrim$1((block) => `
                     Invalid promptbook URL "${pipeline.pipelineUrl}"
 
                     ${block(pipelineIdentification)}
@@ -2516,7 +2568,7 @@ function validatePipeline_InnerFunction(pipeline) {
     }
     if (pipeline.bookVersion !== undefined && !isValidPromptbookVersion(pipeline.bookVersion)) {
         // <- Note: [🚲]
-        throw new PipelineLogicError(spaceTrim((block) => `
+        throw new PipelineLogicError(spaceTrim$1((block) => `
                     Invalid Promptbook Version "${pipeline.bookVersion}"
 
                     ${block(pipelineIdentification)}
@@ -2525,7 +2577,7 @@ function validatePipeline_InnerFunction(pipeline) {
     // TODO: [🧠] Maybe do here some proper JSON-schema / ZOD checking
     if (!Array.isArray(pipeline.parameters)) {
         // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-        throw new ParseError(spaceTrim((block) => `
+        throw new ParseError(spaceTrim$1((block) => `
                     Pipeline is valid JSON but with wrong structure
 
                     \`PipelineJson.parameters\` expected to be an array, but got ${typeof pipeline.parameters}
@@ -2536,7 +2588,7 @@ function validatePipeline_InnerFunction(pipeline) {
     // TODO: [🧠] Maybe do here some proper JSON-schema / ZOD checking
     if (!Array.isArray(pipeline.tasks)) {
         // TODO: [🧠] what is the correct error tp throw - maybe PromptbookSchemaError
-        throw new ParseError(spaceTrim((block) => `
+        throw new ParseError(spaceTrim$1((block) => `
                     Pipeline is valid JSON but with wrong structure
 
                     \`PipelineJson.tasks\` expected to be an array, but got ${typeof pipeline.tasks}
@@ -2562,7 +2614,7 @@ function validatePipeline_InnerFunction(pipeline) {
     // Note: Check each parameter individually
     for (const parameter of pipeline.parameters) {
         if (parameter.isInput && parameter.isOutput) {
-            throw new PipelineLogicError(spaceTrim((block) => `
+            throw new PipelineLogicError(spaceTrim$1((block) => `
 
                         Parameter \`{${parameter.name}}\` can not be both input and output
 
@@ -2573,7 +2625,7 @@ function validatePipeline_InnerFunction(pipeline) {
         if (!parameter.isInput &&
             !parameter.isOutput &&
             !pipeline.tasks.some((task) => task.dependentParameterNames.includes(parameter.name))) {
-            throw new PipelineLogicError(spaceTrim((block) => `
+            throw new PipelineLogicError(spaceTrim$1((block) => `
                         Parameter \`{${parameter.name}}\` is created but not used
 
                         You can declare {${parameter.name}} as output parameter by adding in the header:
@@ -2585,7 +2637,7 @@ function validatePipeline_InnerFunction(pipeline) {
         }
         // Note: Testing that parameter is either input or result of some task
         if (!parameter.isInput && !pipeline.tasks.some((task) => task.resultingParameterName === parameter.name)) {
-            throw new PipelineLogicError(spaceTrim((block) => `
+            throw new PipelineLogicError(spaceTrim$1((block) => `
                         Parameter \`{${parameter.name}}\` is declared but not defined
 
                         You can do one of these:
@@ -2601,14 +2653,14 @@ function validatePipeline_InnerFunction(pipeline) {
     // Note: Checking each task individually
     for (const task of pipeline.tasks) {
         if (definedParameters.has(task.resultingParameterName)) {
-            throw new PipelineLogicError(spaceTrim((block) => `
+            throw new PipelineLogicError(spaceTrim$1((block) => `
                         Parameter \`{${task.resultingParameterName}}\` is defined multiple times
 
                         ${block(pipelineIdentification)}
                     `));
         }
         if (RESERVED_PARAMETER_NAMES.includes(task.resultingParameterName)) {
-            throw new PipelineLogicError(spaceTrim((block) => `
+            throw new PipelineLogicError(spaceTrim$1((block) => `
                         Parameter name {${task.resultingParameterName}} is reserved, please use different name
 
                         ${block(pipelineIdentification)}
@@ -2618,7 +2670,7 @@ function validatePipeline_InnerFunction(pipeline) {
         if (task.jokerParameterNames && task.jokerParameterNames.length > 0) {
             if (!task.format &&
                 !task.expectations /* <- TODO: Require at least 1 -> min <- expectation to use jokers */) {
-                throw new PipelineLogicError(spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1((block) => `
                             Joker parameters are used for {${task.resultingParameterName}} but no expectations are defined
 
                             ${block(pipelineIdentification)}
@@ -2626,7 +2678,7 @@ function validatePipeline_InnerFunction(pipeline) {
             }
             for (const joker of task.jokerParameterNames) {
                 if (!task.dependentParameterNames.includes(joker)) {
-                    throw new PipelineLogicError(spaceTrim((block) => `
+                    throw new PipelineLogicError(spaceTrim$1((block) => `
                                 Parameter \`{${joker}}\` is used for {${task.resultingParameterName}} as joker but not in \`dependentParameterNames\`
 
                                 ${block(pipelineIdentification)}
@@ -2637,21 +2689,21 @@ function validatePipeline_InnerFunction(pipeline) {
         if (task.expectations) {
             for (const [unit, { min, max }] of Object.entries(task.expectations)) {
                 if (min !== undefined && max !== undefined && min > max) {
-                    throw new PipelineLogicError(spaceTrim((block) => `
+                    throw new PipelineLogicError(spaceTrim$1((block) => `
                                 Min expectation (=${min}) of ${unit} is higher than max expectation (=${max})
 
                                 ${block(pipelineIdentification)}
                             `));
                 }
                 if (min !== undefined && min < 0) {
-                    throw new PipelineLogicError(spaceTrim((block) => `
+                    throw new PipelineLogicError(spaceTrim$1((block) => `
                                 Min expectation of ${unit} must be zero or positive
 
                                 ${block(pipelineIdentification)}
                             `));
                 }
                 if (max !== undefined && max <= 0) {
-                    throw new PipelineLogicError(spaceTrim((block) => `
+                    throw new PipelineLogicError(spaceTrim$1((block) => `
                                 Max expectation of ${unit} must be positive
 
                                 ${block(pipelineIdentification)}
@@ -2673,7 +2725,7 @@ function validatePipeline_InnerFunction(pipeline) {
     while (unresovedTasks.length > 0) {
         if (loopLimit-- < 0) {
             // Note: Really UnexpectedError not LimitReachedError - this should not happen and be caught below
-            throw new UnexpectedError(spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1((block) => `
                         Loop limit reached during detection of circular dependencies in \`validatePipeline\`
 
                         ${block(pipelineIdentification)}
@@ -2683,7 +2735,7 @@ function validatePipeline_InnerFunction(pipeline) {
         if (currentlyResovedTasks.length === 0) {
             throw new PipelineLogicError(
             // TODO: [🐎] DRY
-            spaceTrim((block) => `
+            spaceTrim$1((block) => `
 
                         Can not resolve some parameters:
                         Either you are using a parameter that is not defined, or there are some circular dependencies.
@@ -2820,7 +2872,7 @@ function jsonParse(value) {
     }
     else if (typeof value !== 'string') {
         console.error('Can not parse JSON from non-string value.', { text: value });
-        throw new Error(spaceTrim$1(`
+        throw new Error(spaceTrim$2(`
                     Can not parse JSON from non-string value.
 
                     The value type: ${typeof value}
@@ -2834,7 +2886,7 @@ function jsonParse(value) {
         if (!(error instanceof Error)) {
             throw error;
         }
-        throw new Error(spaceTrim$1((block) => `
+        throw new Error(spaceTrim$2((block) => `
                     ${block(error.message)}
 
                     The expected JSON text:
@@ -2887,7 +2939,7 @@ function deserializeError(error) {
         message = `${name}: ${message}`;
     }
     if (stack !== undefined && stack !== '') {
-        message = spaceTrim$1((block) => `
+        message = spaceTrim$2((block) => `
                 ${block(message)}
 
                 Original stack trace:
@@ -2924,11 +2976,11 @@ function assertsTaskSuccessful(executionResult) {
         throw deserializeError(errors[0]);
     }
     else {
-        throw new PipelineExecutionError(spaceTrim((block) => `
+        throw new PipelineExecutionError(spaceTrim$1((block) => `
                     Multiple errors occurred during Promptbook execution
 
                     ${block(errors
-            .map(({ name, stack, message }, index) => spaceTrim((block) => `
+            .map(({ name, stack, message }, index) => spaceTrim$1((block) => `
                                         ${name} ${index + 1}:
                                         ${block(stack || message)}
                                     `))
@@ -3440,7 +3492,7 @@ function pipelineJsonToString(pipelineJson) {
         pipelineString += '\n\n';
         pipelineString += '```' + contentLanguage;
         pipelineString += '\n';
-        pipelineString += spaceTrim$1(content);
+        pipelineString += spaceTrim$2(content);
         //                   <- TODO: [main] !!3 Escape
         //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
         pipelineString += '\n';
@@ -3545,7 +3597,7 @@ class SimplePipelineCollection {
         for (const pipeline of pipelines) {
             // TODO: [👠] DRY
             if (pipeline.pipelineUrl === undefined) {
-                throw new PipelineUrlError(spaceTrim(`
+                throw new PipelineUrlError(spaceTrim$1(`
                         Pipeline with name "${pipeline.title}" does not have defined URL
 
                         File:
@@ -3567,7 +3619,7 @@ class SimplePipelineCollection {
                 pipelineJsonToString(unpreparePipeline(pipeline)) !==
                     pipelineJsonToString(unpreparePipeline(this.collection.get(pipeline.pipelineUrl)))) {
                 const existing = this.collection.get(pipeline.pipelineUrl);
-                throw new PipelineUrlError(spaceTrim(`
+                throw new PipelineUrlError(spaceTrim$1(`
                         Pipeline with URL ${pipeline.pipelineUrl} is already in the collection 🍎
 
                         Conflicting files:
@@ -3599,13 +3651,13 @@ class SimplePipelineCollection {
         const pipeline = this.collection.get(url);
         if (!pipeline) {
             if (this.listPipelines().length === 0) {
-                throw new NotFoundError(spaceTrim(`
+                throw new NotFoundError(spaceTrim$1(`
                             Pipeline with url "${url}" not found
 
                             No pipelines available
                         `));
             }
-            throw new NotFoundError(spaceTrim((block) => `
+            throw new NotFoundError(spaceTrim$1((block) => `
                         Pipeline with url "${url}" not found
 
                         Available pipelines:
@@ -3836,14 +3888,14 @@ class MultipleLlmExecutionTools {
             if (description === undefined) {
                 return headLine;
             }
-            return spaceTrim$1((block) => `
+            return spaceTrim$2((block) => `
                         ${headLine}
 
                           ${ /* <- Note: Indenting the description: */block(description)}
                     `);
         })
             .join('\n\n');
-        return spaceTrim$1((block) => `
+        return spaceTrim$2((block) => `
                 Multiple LLM Providers:
 
                 ${block(innerModelsTitlesAndDescriptions)}
@@ -3934,7 +3986,7 @@ class MultipleLlmExecutionTools {
             //     1) OpenAI throw PipelineExecutionError: Parameter `{knowledge}` is not defined
             //     2) AnthropicClaude throw PipelineExecutionError: Parameter `{knowledge}` is not defined
             //     3) ...
-            spaceTrim$1((block) => `
+            spaceTrim$2((block) => `
                           All execution tools of ${this.title} failed:
 
                           ${block(errors
@@ -3947,7 +3999,7 @@ class MultipleLlmExecutionTools {
             throw new PipelineExecutionError(`You have not provided any \`LlmExecutionTools\` into ${this.title}`);
         }
         else {
-            throw new PipelineExecutionError(spaceTrim$1((block) => `
+            throw new PipelineExecutionError(spaceTrim$2((block) => `
                           You have not provided any \`LlmExecutionTools\` that support model variant "${prompt.modelRequirements.modelVariant}" into ${this.title}
 
                           Available \`LlmExecutionTools\`:
@@ -3980,7 +4032,7 @@ class MultipleLlmExecutionTools {
  */
 function joinLlmExecutionTools(title, ...llmExecutionTools) {
     if (llmExecutionTools.length === 0) {
-        const warningMessage = spaceTrim$1(`
+        const warningMessage = spaceTrim$2(`
             You have not provided any \`LlmExecutionTools\`
             This means that you won't be able to execute any prompts that require large language models like GPT-4 or Anthropic's Claude.
 
@@ -4297,14 +4349,14 @@ function $registeredScrapersMessage(availableScrapers) {
         return { ...metadata, isMetadataAviailable, isInstalled, isAvailableInTools };
     });
     if (metadata.length === 0) {
-        return spaceTrim$1(`
+        return spaceTrim$2(`
             **No scrapers are available**
 
             This is a unexpected behavior, you are probably using some broken version of Promptbook
             At least there should be available the metadata of the scrapers
         `);
     }
-    return spaceTrim$1((block) => `
+    return spaceTrim$2((block) => `
             Available scrapers are:
             ${block(metadata
         .map(({ packageName, className, isMetadataAviailable, isInstalled, mimeTypes, isAvailableInBrowser, isAvailableInTools, }, i) => {
@@ -4810,7 +4862,7 @@ const promptbookFetch = async (urlOrRequest, init) => {
         else if (urlOrRequest instanceof Request) {
             url = urlOrRequest.url;
         }
-        throw new PromptbookFetchError(spaceTrim$1((block) => `
+        throw new PromptbookFetchError(spaceTrim$2((block) => `
                     Can not fetch "${url}"
 
                     Fetch error:
@@ -4971,7 +5023,7 @@ async function makeKnowledgeSourceHandler(knowledgeSource, tools, options) {
         const fileExtension = getFileExtension(filename);
         const mimeType = extensionToMimeType(fileExtension || '');
         if (!(await isFileExisting(filename, tools.fs))) {
-            throw new NotFoundError(spaceTrim$1((block) => `
+            throw new NotFoundError(spaceTrim$2((block) => `
                           Can not make source handler for file which does not exist:
 
                           File:
@@ -5064,7 +5116,7 @@ async function prepareKnowledgePieces(knowledgeSources, tools, options) {
                     // <- TODO: [🪓] Here should be no need for spreading new array, just `partialPieces = partialPiecesUnchecked`
                     break;
                 }
-                console.warn(spaceTrim$1((block) => `
+                console.warn(spaceTrim$2((block) => `
                             Cannot scrape knowledge from source despite the scraper \`${scraper.metadata.className}\` supports the mime type "${sourceHandler.mimeType}".
 
                             The source:
@@ -5080,7 +5132,7 @@ async function prepareKnowledgePieces(knowledgeSources, tools, options) {
                 // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             }
             if (partialPieces === null) {
-                throw new KnowledgeScrapeError(spaceTrim$1((block) => `
+                throw new KnowledgeScrapeError(spaceTrim$2((block) => `
                             Cannot scrape knowledge
 
                             The source:
@@ -5159,7 +5211,7 @@ async function prepareTasks(pipeline, tools, options) {
         if (task.taskType === 'PROMPT_TASK' &&
             knowledgePiecesCount > 0 &&
             !dependentParameterNames.includes('knowledge')) {
-            preparedContent = spaceTrim(`
+            preparedContent = spaceTrim$1(`
                     {content}
 
                     ## Knowledge
@@ -5472,7 +5524,7 @@ function extractVariablesFromJavascript(script) {
     }
     catch (error) {
         assertsError(error);
-        throw new ParseError(spaceTrim((block) => `
+        throw new ParseError(spaceTrim$1((block) => `
                     Can not extract variables from the script
                     ${block(error.stack || error.message)}
 
@@ -5655,7 +5707,7 @@ const CsvFormatParser = {
                 const { value, outputParameterName, settings, mapCallback, onProgress } = options;
                 const csv = csvParse(value, settings);
                 if (csv.errors.length !== 0) {
-                    throw new CsvFormatError(spaceTrim$1((block) => `
+                    throw new CsvFormatError(spaceTrim$2((block) => `
                                 CSV parsing error
 
                                 Error(s) from CSV parsing:
@@ -5700,7 +5752,7 @@ const CsvFormatParser = {
                 const { value, settings, mapCallback, onProgress } = options;
                 const csv = csvParse(value, settings);
                 if (csv.errors.length !== 0) {
-                    throw new CsvFormatError(spaceTrim$1((block) => `
+                    throw new CsvFormatError(spaceTrim$2((block) => `
                                 CSV parsing error
 
                                 Error(s) from CSV parsing:
@@ -5910,7 +5962,7 @@ function mapAvailableToExpectedParameters(options) {
     }
     // Phase 2️⃣: Non-matching mapping
     if (expectedParameterNames.size !== availableParametersNames.size) {
-        throw new PipelineExecutionError(spaceTrim$1((block) => `
+        throw new PipelineExecutionError(spaceTrim$2((block) => `
                     Can not map available parameters to expected parameters
 
                     Mapped parameters:
@@ -6326,7 +6378,7 @@ function validatePromptResult(options) {
                     }
                     catch (error) {
                         keepUnused(error);
-                        throw new ExpectError(spaceTrim((block) => `
+                        throw new ExpectError(spaceTrim$1((block) => `
                                     Expected valid JSON string
 
                                     The expected JSON text:
@@ -6389,7 +6441,7 @@ async function executeAttempts(options) {
         const jokerParameterName = jokerParameterNames[jokerParameterNames.length + attemptIndex];
         // TODO: [🧠][🍭] JOKERS, EXPECTATIONS, POSTPROCESSING and FOREACH
         if (isJokerAttempt && !jokerParameterName) {
-            throw new UnexpectedError(spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1((block) => `
                         Joker not found in attempt ${attemptIndex}
 
                         ${block(pipelineIdentification)}
@@ -6400,7 +6452,7 @@ async function executeAttempts(options) {
         $ongoingTaskResult.$expectError = null;
         if (isJokerAttempt) {
             if (parameters[jokerParameterName] === undefined) {
-                throw new PipelineExecutionError(spaceTrim((block) => `
+                throw new PipelineExecutionError(spaceTrim$1((block) => `
                             Joker parameter {${jokerParameterName}} not defined
 
                             ${block(pipelineIdentification)}
@@ -6458,7 +6510,7 @@ async function executeAttempts(options) {
                                     $ongoingTaskResult.$resultString = $ongoingTaskResult.$completionResult.content;
                                     break variant;
                                 case 'EMBEDDING':
-                                    throw new PipelineExecutionError(spaceTrim((block) => `
+                                    throw new PipelineExecutionError(spaceTrim$1((block) => `
                                                 Embedding model can not be used in pipeline
 
                                                 This should be catched during parsing
@@ -6469,7 +6521,7 @@ async function executeAttempts(options) {
                                     break variant;
                                 // <- case [🤖]:
                                 default:
-                                    throw new PipelineExecutionError(spaceTrim((block) => `
+                                    throw new PipelineExecutionError(spaceTrim$1((block) => `
                                                 Unknown model variant "${task.modelRequirements.modelVariant}"
 
                                                 ${block(pipelineIdentification)}
@@ -6480,14 +6532,14 @@ async function executeAttempts(options) {
                         break;
                     case 'SCRIPT_TASK':
                         if (arrayableToArray(tools.script).length === 0) {
-                            throw new PipelineExecutionError(spaceTrim((block) => `
+                            throw new PipelineExecutionError(spaceTrim$1((block) => `
                                         No script execution tools are available
 
                                         ${block(pipelineIdentification)}
                                     `));
                         }
                         if (!task.contentLanguage) {
-                            throw new PipelineExecutionError(spaceTrim((block) => `
+                            throw new PipelineExecutionError(spaceTrim$1((block) => `
                                         Script language is not defined for SCRIPT TASK "${task.name}"
 
                                         ${block(pipelineIdentification)}
@@ -6518,7 +6570,7 @@ async function executeAttempts(options) {
                             throw $ongoingTaskResult.$scriptPipelineExecutionErrors[0];
                         }
                         else {
-                            throw new PipelineExecutionError(spaceTrim((block) => `
+                            throw new PipelineExecutionError(spaceTrim$1((block) => `
                                         Script execution failed ${$ongoingTaskResult.$scriptPipelineExecutionErrors.length}x
 
                                         ${block(pipelineIdentification)}
@@ -6532,7 +6584,7 @@ async function executeAttempts(options) {
                         break taskType;
                     case 'DIALOG_TASK':
                         if (tools.userInterface === undefined) {
-                            throw new PipelineExecutionError(spaceTrim((block) => `
+                            throw new PipelineExecutionError(spaceTrim$1((block) => `
                                         User interface tools are not available
 
                                         ${block(pipelineIdentification)}
@@ -6550,7 +6602,7 @@ async function executeAttempts(options) {
                         break taskType;
                     // <- case: [🅱]
                     default:
-                        throw new PipelineExecutionError(spaceTrim((block) => `
+                        throw new PipelineExecutionError(spaceTrim$1((block) => `
                                     Unknown execution type "${task.taskType}"
 
                                     ${block(pipelineIdentification)}
@@ -6648,7 +6700,7 @@ async function executeAttempts(options) {
         if ($ongoingTaskResult.$expectError !== null && attemptIndex === maxAttempts - 1) {
             // Note: Create a summary of all failures
             const failuresSummary = $ongoingTaskResult.$failedResults
-                .map((failure) => spaceTrim((block) => {
+                .map((failure) => spaceTrim$1((block) => {
                 var _a, _b;
                 return `
                             Attempt ${failure.attemptIndex + 1}:
@@ -6658,14 +6710,14 @@ async function executeAttempts(options) {
                             Result:
                             ${block(failure.result === null
                     ? 'null'
-                    : spaceTrim(failure.result)
+                    : spaceTrim$1(failure.result)
                         .split('\n')
                         .map((line) => `> ${line}`)
                         .join('\n'))}
                         `;
             }))
                 .join('\n\n---\n\n');
-            throw new PipelineExecutionError(spaceTrim((block) => {
+            throw new PipelineExecutionError(spaceTrim$1((block) => {
                 var _a;
                 return `
                         LLM execution failed ${maxExecutionAttempts}x
@@ -6685,7 +6737,7 @@ async function executeAttempts(options) {
         }
     }
     if ($ongoingTaskResult.$resultString === null) {
-        throw new UnexpectedError(spaceTrim((block) => `
+        throw new UnexpectedError(spaceTrim$1((block) => `
                     Something went wrong and prompt result is null
 
                     ${block(pipelineIdentification)}
@@ -6712,7 +6764,7 @@ async function executeFormatSubvalues(options) {
         return /* not await */ executeAttempts({ ...options, logLlmCall });
     }
     if (jokerParameterNames.length !== 0) {
-        throw new UnexpectedError(spaceTrim$1((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     JOKER parameters are not supported together with FOREACH command
 
                     [🧞‍♀️] This should be prevented in \`validatePipeline\`
@@ -6725,7 +6777,7 @@ async function executeFormatSubvalues(options) {
     if (formatDefinition === undefined) {
         throw new UnexpectedError(
         // <- TODO: [🧠][🧐] Should be formats fixed per promptbook version or behave as plugins (=> change UnexpectedError)
-        spaceTrim$1((block) => `
+        spaceTrim$2((block) => `
                     Unsupported format "${task.foreach.formatName}"
 
                     Available formats:
@@ -6742,7 +6794,7 @@ async function executeFormatSubvalues(options) {
     if (subvalueParser === undefined) {
         throw new UnexpectedError(
         // <- TODO: [🧠][🧐] Should be formats fixed per promptbook version or behave as plugins (=> change UnexpectedError)
-        spaceTrim$1((block) => `
+        spaceTrim$2((block) => `
                     Unsupported subformat name "${task.foreach.subformatName}" for format "${task.foreach.formatName}"
 
                     Available subformat names for format "${formatDefinition.formatName}":
@@ -6782,7 +6834,7 @@ async function executeFormatSubvalues(options) {
                 if (!(error instanceof PipelineExecutionError)) {
                     throw error;
                 }
-                const highLevelError = new PipelineExecutionError(spaceTrim$1((block) => `
+                const highLevelError = new PipelineExecutionError(spaceTrim$2((block) => `
                             ${error.message}
 
                             This is error in FOREACH command when mapping ${formatDefinition.formatName} ${subvalueParser.subvalueName} data (${index + 1}/${length})
@@ -6806,7 +6858,7 @@ async function executeFormatSubvalues(options) {
                     ...options,
                     priority: priority + index,
                     parameters: allSubparameters,
-                    pipelineIdentification: spaceTrim$1((block) => `
+                    pipelineIdentification: spaceTrim$2((block) => `
                             ${block(pipelineIdentification)}
                             Subparameter index: ${index}
                         `),
@@ -6815,7 +6867,7 @@ async function executeFormatSubvalues(options) {
             }
             catch (error) {
                 if (length > BIG_DATASET_TRESHOLD) {
-                    console.error(spaceTrim$1((block) => `
+                    console.error(spaceTrim$2((block) => `
                               ${error.message}
 
                               This is error in FOREACH command when processing ${formatDefinition.formatName} ${subvalueParser.subvalueName} data (${index + 1}/${length})
@@ -6991,7 +7043,7 @@ async function getReservedParametersForTask(options) {
     // Note: Doublecheck that ALL reserved parameters are defined:
     for (const parameterName of RESERVED_PARAMETER_NAMES) {
         if (reservedParameters[parameterName] === undefined) {
-            throw new UnexpectedError(spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1((block) => `
                         Reserved parameter {${parameterName}} is not defined
 
                         ${block(pipelineIdentification)}
@@ -7017,7 +7069,7 @@ async function executeTask(options) {
     const dependentParameterNames = new Set(currentTask.dependentParameterNames);
     // TODO: [👩🏾‍🤝‍👩🏻] Use here `mapAvailableToExpectedParameters`
     if (difference(union(difference(usedParameterNames, dependentParameterNames), difference(dependentParameterNames, usedParameterNames)), new Set(RESERVED_PARAMETER_NAMES)).size !== 0) {
-        throw new UnexpectedError(spaceTrim((block) => `
+        throw new UnexpectedError(spaceTrim$1((block) => `
                     Dependent parameters are not consistent with used parameters:
 
                     Dependent parameters:
@@ -7061,7 +7113,7 @@ async function executeTask(options) {
         else if (!definedParameterNames.has(parameterName) && usedParameterNames.has(parameterName)) {
             // Houston, we have a problem
             // Note: Checking part is also done in `validatePipeline`, but it’s good to doublecheck
-            throw new UnexpectedError(spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1((block) => `
                         Parameter \`{${parameterName}}\` is NOT defined
                         BUT used in task "${currentTask.title || currentTask.name}"
 
@@ -7130,7 +7182,7 @@ function filterJustOutputParameters(options) {
     for (const parameter of preparedPipeline.parameters.filter(({ isOutput }) => isOutput)) {
         if (parametersToPass[parameter.name] === undefined) {
             // [4]
-            $warnings.push(new PipelineExecutionError(spaceTrim((block) => `
+            $warnings.push(new PipelineExecutionError(spaceTrim$1((block) => `
                             Parameter \`{${parameter.name}}\` should be an output parameter, but it was not generated during pipeline execution
 
                             Note: This is a warning which happened after the pipeline was executed, and \`{${parameter.name}}\` was not for some reason defined in output parameters
@@ -7238,7 +7290,7 @@ async function executePipeline(options) {
     for (const parameterName of Object.keys(inputParameters)) {
         const parameter = preparedPipeline.parameters.find(({ name }) => name === parameterName);
         if (parameter === undefined) {
-            warnings.push(new PipelineExecutionError(spaceTrim((block) => `
+            warnings.push(new PipelineExecutionError(spaceTrim$1((block) => `
                             Extra parameter {${parameterName}} is being passed which is not part of the pipeline.
 
                             ${block(pipelineIdentification)}
@@ -7253,7 +7305,7 @@ async function executePipeline(options) {
             // TODO: [🧠] This should be also non-critical error
             return exportJson({
                 name: 'pipelineExecutorResult',
-                message: spaceTrim((block) => `
+                message: spaceTrim$1((block) => `
                         Unsuccessful PipelineExecutorResult (with extra parameter {${parameter.name}}) PipelineExecutorResult
 
                         ${block(pipelineIdentification)}
@@ -7262,7 +7314,7 @@ async function executePipeline(options) {
                 value: {
                     isSuccessful: false,
                     errors: [
-                        new PipelineExecutionError(spaceTrim((block) => `
+                        new PipelineExecutionError(spaceTrim$1((block) => `
                                     Parameter \`{${parameter.name}}\` is passed as input parameter but it is not input
 
                                     ${block(pipelineIdentification)}
@@ -7289,7 +7341,7 @@ async function executePipeline(options) {
         while (unresovedTasks.length > 0) {
             if (loopLimit-- < 0) {
                 // Note: Really UnexpectedError not LimitReachedError - this should be catched during validatePipeline
-                throw new UnexpectedError(spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1((block) => `
                             Loop limit reached during resolving parameters pipeline execution
 
                             ${block(pipelineIdentification)}
@@ -7299,7 +7351,7 @@ async function executePipeline(options) {
             if (!currentTask && resolving.length === 0) {
                 throw new UnexpectedError(
                 // TODO: [🐎] DRY
-                spaceTrim((block) => `
+                spaceTrim$1((block) => `
                             Can not resolve some parameters:
 
                             ${block(pipelineIdentification)}
@@ -7339,7 +7391,7 @@ async function executePipeline(options) {
                     tools,
                     onProgress(newOngoingResult) {
                         if (isReturned) {
-                            throw new UnexpectedError(spaceTrim((block) => `
+                            throw new UnexpectedError(spaceTrim$1((block) => `
                                         Can not call \`onProgress\` after pipeline execution is finished
 
                                         ${block(pipelineIdentification)}
@@ -7356,7 +7408,7 @@ async function executePipeline(options) {
                     },
                     logLlmCall,
                     $executionReport: executionReport,
-                    pipelineIdentification: spaceTrim((block) => `
+                    pipelineIdentification: spaceTrim$1((block) => `
                             ${block(pipelineIdentification)}
                             Task name: ${currentTask.name}
                             Task title: ${currentTask.title}
@@ -7465,7 +7517,7 @@ function createPipelineExecutor(options) {
         preparedPipeline = pipeline;
     }
     else if (isNotPreparedWarningSuppressed !== true) {
-        console.warn(spaceTrim((block) => `
+        console.warn(spaceTrim$1((block) => `
                     Pipeline is not prepared
 
                     ${block(pipelineIdentification)}
@@ -7490,7 +7542,7 @@ function createPipelineExecutor(options) {
             tools,
             onProgress,
             logLlmCall,
-            pipelineIdentification: spaceTrim((block) => `
+            pipelineIdentification: spaceTrim$1((block) => `
                     ${block(pipelineIdentification)}
                     ${runCount === 1 ? '' : `Run #${runCount}`}
                 `),
@@ -7704,13 +7756,13 @@ function $registeredLlmToolsMessage() {
     });
     const usedEnvMessage = `Unknown \`.env\` file` ;
     if (metadata.length === 0) {
-        return spaceTrim$1((block) => `
+        return spaceTrim$2((block) => `
                 No LLM providers are available.
 
                 ${block(usedEnvMessage)}
           `);
     }
-    return spaceTrim$1((block) => `
+    return spaceTrim$2((block) => `
 
             ${block(usedEnvMessage)}
 
@@ -7756,7 +7808,7 @@ function $registeredLlmToolsMessage() {
                 morePieces.push(`Not configured`); // <- Note: Can not be configured via environment variables
             }
         }
-        let providerMessage = spaceTrim$1(`
+        let providerMessage = spaceTrim$2(`
                                 ${i + 1}) **${title}** \`${className}\` from \`${packageName}\`
                                     ${morePieces.join('; ')}
                             `);
@@ -7802,7 +7854,7 @@ function createLlmToolsFromConfiguration(configuration, options = {}) {
             .find(({ packageName, className }) => llmConfiguration.packageName === packageName && llmConfiguration.className === className);
         if (registeredItem === undefined) {
             // console.log('$llmToolsRegister.list()', $llmToolsRegister.list());
-            throw new Error(spaceTrim$1((block) => `
+            throw new Error(spaceTrim$2((block) => `
                         There is no constructor for LLM provider \`${llmConfiguration.className}\` from \`${llmConfiguration.packageName}\`
                         Running in ${!$isRunningInBrowser() ? '' : 'browser environment'}${!$isRunningInNode() ? '' : 'node environment'}${!$isRunningInWebWorker() ? '' : 'worker environment'}
 
@@ -8068,7 +8120,7 @@ function unwrapResult(text, options) {
     let trimmedText = text;
     // Remove leading and trailing spaces and newlines
     if (isTrimmed) {
-        trimmedText = spaceTrim(trimmedText);
+        trimmedText = spaceTrim$1(trimmedText);
     }
     let processedText = trimmedText;
     if (isIntroduceSentenceRemoved) {
@@ -8077,7 +8129,7 @@ function unwrapResult(text, options) {
             // Remove the introduce sentence and quotes by replacing it with an empty string
             processedText = processedText.replace(introduceSentenceRegex, '');
         }
-        processedText = spaceTrim(processedText);
+        processedText = spaceTrim$1(processedText);
     }
     if (processedText.length < 3) {
         return trimmedText;
@@ -8140,7 +8192,7 @@ function unwrapResult(text, options) {
 function extractOneBlockFromMarkdown(markdown) {
     const codeBlocks = extractAllBlocksFromMarkdown(markdown);
     if (codeBlocks.length !== 1) {
-        throw new ParseError(spaceTrim$1((block) => `
+        throw new ParseError(spaceTrim$2((block) => `
                     There should be exactly 1 code block in task section, found ${codeBlocks.length} code blocks
 
                     ${block(codeBlocks.map((block, i) => `Block ${i + 1}:\n${block.content}`).join('\n\n\n'))}
@@ -8181,13 +8233,13 @@ function extractBlock(markdown) {
  * @public exported from `@promptbook/markdown-utils`
  */
 function trimCodeBlock(value) {
-    value = spaceTrim(value);
+    value = spaceTrim$1(value);
     if (!/^```[a-z]*(.*)```$/is.test(value)) {
         return value;
     }
     value = value.replace(/^```[a-z]*/i, '');
     value = value.replace(/```$/i, '');
-    value = spaceTrim(value);
+    value = spaceTrim$1(value);
     return value;
 }
 
@@ -8200,9 +8252,9 @@ function trimCodeBlock(value) {
  * @public exported from `@promptbook/markdown-utils`
  */
 function trimEndOfCodeBlock(value) {
-    value = spaceTrim(value);
+    value = spaceTrim$1(value);
     value = value.replace(/```$/g, '');
-    value = spaceTrim(value);
+    value = spaceTrim$1(value);
     return value;
 }
 
@@ -8249,7 +8301,7 @@ class JavascriptEvalExecutionTools {
         }
         // Note: [💎]
         // Note: Using direct eval, following variables are in same scope as eval call so they are accessible from inside the evaluated script:
-        const spaceTrim = (_) => spaceTrim$1(_);
+        const spaceTrim = (_) => spaceTrim$2(_);
         $preserve(spaceTrim);
         const removeQuotes$1 = removeQuotes;
         $preserve(removeQuotes$1);
@@ -8340,7 +8392,7 @@ class JavascriptEvalExecutionTools {
             .join('\n');
         // script = templateParameters(script, parameters);
         // <- TODO: [🧠][🥳] Should be this is one of two variants how to use parameters in script
-        const statementToEvaluate = spaceTrim$1((block) => `
+        const statementToEvaluate = spaceTrim$2((block) => `
 
                 // Build-in functions:
                 ${block(buildinFunctionsStatement)}
@@ -8355,7 +8407,7 @@ class JavascriptEvalExecutionTools {
                 (()=>{ ${script} })()
             `);
         if (this.options.isVerbose) {
-            console.info(spaceTrim$1((block) => `
+            console.info(spaceTrim$2((block) => `
                         🚀 Evaluating ${scriptLanguage} script:
 
                         ${block(statementToEvaluate)}`));
@@ -8377,7 +8429,7 @@ class JavascriptEvalExecutionTools {
                       To:   [PipelineExecutionError: Parameter `{thing}` is not defined],
                 */
                 if (!statementToEvaluate.includes(undefinedName + '(')) {
-                    throw new PipelineExecutionError(spaceTrim$1((block) => `
+                    throw new PipelineExecutionError(spaceTrim$2((block) => `
 
                                 Parameter \`{${undefinedName}}\` is not defined
 
@@ -8399,7 +8451,7 @@ class JavascriptEvalExecutionTools {
                             `));
                 }
                 else {
-                    throw new PipelineExecutionError(spaceTrim$1((block) => `
+                    throw new PipelineExecutionError(spaceTrim$2((block) => `
                                   Function ${undefinedName}() is not defined
 
                                   -  Make sure that the function is one of built-in functions
@@ -9266,7 +9318,7 @@ function startRemoteServer(options) {
             response.type('text/html').send(renderServerIndexHtml(serverInfo));
         }
         else {
-            response.type('text/markdown').send(await spaceTrim(async (block) => `
+            response.type('text/markdown').send(await spaceTrim$1(async (block) => `
                         # Promptbook
 
                         > ${block(CLAIM)}