@promptbook/wizard 0.103.0-54 → 0.103.0-56

package/esm/index.es.js

@@ -1,4 +1,4 @@
-import spaceTrim, { spaceTrim as spaceTrim$1 } from 'spacetrim';
+import spaceTrim$2, { spaceTrim as spaceTrim$1 } from 'spacetrim';
 import { randomBytes } from 'crypto';
 import { io } from 'socket.io-client';
 import Anthropic from '@anthropic-ai/sdk';
@@ -36,7 +36,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-54';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-56';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -90,6 +90,17 @@ const REMOTE_SERVER_URLS = [
  * 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;
+
 /**
  * Just marks a place of place where should be something implemented
  * No side effects.
@@ -151,6 +162,7 @@ function take(initialValue) {
  * @public exported from `@promptbook/color`
  */
 const CSS_COLORS = {
+    promptbook: '#79EAFD',
     transparent: 'rgba(0,0,0,0)',
     aliceblue: '#f0f8ff',
     antiquewhite: '#faebd7',
@@ -366,6 +378,28 @@ class 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
      *
@@ -975,7 +1009,7 @@ const ADMIN_GITHUB_NAME = 'hejny';
  *
  * @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/>`
@@ -1291,7 +1325,7 @@ function $deepFreeze(objectValue) {
 function getErrorReportUrl(error) {
     const report = {
         title: `🐜 Error report from ${NAME}`,
-        body: spaceTrim((block) => `
+        body: spaceTrim$2((block) => `
 
 
             \`${error.name || 'Error'}\` has occurred in the [${NAME}], please look into it @${ADMIN_GITHUB_NAME}.
@@ -1449,7 +1483,7 @@ function checkSerializableAsJson(options) {
     }
     else if (typeof value === 'object') {
         if (value instanceof Date) {
-            throw new UnexpectedError(spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         \`${name}\` is Date
 
                         Use \`string_date_iso8601\` instead
@@ -1468,7 +1502,7 @@ function checkSerializableAsJson(options) {
             throw new UnexpectedError(`${name} is RegExp`);
         }
         else if (value instanceof Error) {
-            throw new UnexpectedError(spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         \`${name}\` is unserialized Error
 
                         Use function \`serializeError\`
@@ -1491,7 +1525,7 @@ function checkSerializableAsJson(options) {
             }
             catch (error) {
                 assertsError(error);
-                throw new UnexpectedError(spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$2((block) => `
                             \`${name}\` is not serializable
 
                             ${block(error.stack || error.message)}
@@ -1523,7 +1557,7 @@ function checkSerializableAsJson(options) {
         }
     }
     else {
-        throw new UnexpectedError(spaceTrim((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     \`${name}\` is unknown type
 
                     Additional message for \`${name}\`:
@@ -2254,7 +2288,7 @@ function deserializeError(error) {
         message = `${name}: ${message}`;
     }
     if (stack !== undefined && stack !== '') {
-        message = spaceTrim((block) => `
+        message = spaceTrim$2((block) => `
                 ${block(message)}
 
                 Original stack trace:
@@ -2311,7 +2345,7 @@ async function createRemoteClient(options) {
     const remoteServerUrlParsed = new URL(remoteServerUrl);
     if (remoteServerUrlParsed.pathname !== '/' && remoteServerUrlParsed.pathname !== '') {
         remoteServerUrlParsed.pathname = '/';
-        throw new Error(spaceTrim((block) => `
+        throw new Error(spaceTrim$2((block) => `
                         Remote server requires root url \`/\`
 
                         You have provided \`remoteServerUrl\`:
@@ -3538,7 +3572,7 @@ class AnthropicClaudeExecutionTools {
     getDefaultModel(defaultModelName) {
         const model = ANTHROPIC_CLAUDE_MODELS.find(({ modelName }) => modelName.startsWith(defaultModelName));
         if (model === undefined) {
-            throw new UnexpectedError(spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                           Cannot find model in Anthropic Claude models with name "${defaultModelName}" which should be used as default.
 
                           Available models:
@@ -4778,7 +4812,7 @@ function createExecutionToolsFromVercelProvider(options) {
             const modelName = modelRequirements.modelName ||
                 ((_a = availableModels.find(({ modelVariant }) => modelVariant === 'CHAT')) === null || _a === void 0 ? void 0 : _a.modelName);
             if (!modelName) {
-                throw new PipelineExecutionError(spaceTrim(`
+                throw new PipelineExecutionError(spaceTrim$2(`
                         Can not determine which model to use.
 
                         You need to provide at least one of:
@@ -6156,7 +6190,7 @@ class OpenAiCompatibleExecutionTools {
         // Note: Match exact or prefix for model families
         const model = this.HARDCODED_MODELS.find(({ modelName }) => modelName === defaultModelName || modelName.startsWith(defaultModelName));
         if (model === undefined) {
-            throw new PipelineExecutionError(spaceTrim((block) => `
+            throw new PipelineExecutionError(spaceTrim$2((block) => `
                             Cannot find model in ${this.title} models with name "${defaultModelName}" which should be used as default.
 
                             Available models:
@@ -6900,18 +6934,26 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
             modelName: 'assistant',
             //          <- [🧠] What is the best value here
         });
+        // Build thread messages: include previous thread messages + current user message
+        const threadMessages = [];
+        // TODO: [🈹] Maybe this should not be here but in other place, look at commit 39d705e75e5bcf7a818c3af36bc13e1c8475c30c
+        // Add previous messages from thread (if any)
+        if ('thread' in prompt &&
+            Array.isArray(prompt.thread)) {
+            const previousMessages = prompt.thread.map((msg) => ({
+                role: (msg.role === 'assistant' ? 'assistant' : 'user'),
+                content: msg.content,
+            }));
+            threadMessages.push(...previousMessages);
+        }
+        // Always add the current user message
+        threadMessages.push({ role: 'user', content: rawPromptContent });
         const rawRequest = {
             // TODO: [👨‍👨‍👧‍👧] ...modelSettings,
             // TODO: [👨‍👨‍👧‍👧][🧠] What about system message for assistants, does it make sense - combination of OpenAI assistants with Promptbook Personas
             assistant_id: this.assistantId,
             thread: {
-                messages: 'thread' in prompt &&
-                    Array.isArray(prompt.thread)
-                    ? prompt.thread.map((msg) => ({
-                        role: msg.role === 'assistant' ? 'assistant' : 'user',
-                        content: msg.content,
-                    }))
-                    : [{ role: 'user', content: rawPromptContent }],
+                messages: threadMessages,
             },
             // <- TODO: Add user identification here> user: this.options.user,
         };
@@ -6931,7 +6973,7 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                 console.info('textDelta', textDelta.value);
             }
             const chunk = {
-                content: textDelta.value || '',
+                content: snapshot.value,
                 modelName: 'assistant',
                 timing: {
                     start,
@@ -8103,7 +8145,7 @@ function pipelineJsonToString(pipelineJson) {
         pipelineString += '\n\n';
         pipelineString += '```' + contentLanguage;
         pipelineString += '\n';
-        pipelineString += spaceTrim(content);
+        pipelineString += spaceTrim$2(content);
         //                   <- TODO: [main] !!3 Escape
         //                   <- TODO: [🧠] Some clear strategy how to spaceTrim the blocks
         pipelineString += '\n';
@@ -8718,7 +8760,7 @@ function serializeError(error) {
     const { name, message, stack } = error;
     const { id } = error;
     if (!Object.keys(ALL_ERRORS).includes(name)) {
-        console.error(spaceTrim((block) => `
+        console.error(spaceTrim$2((block) => `
 
                     Cannot serialize error with name "${name}"
 
@@ -8751,7 +8793,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(`
+        throw new Error(spaceTrim$2(`
                     Can not parse JSON from non-string value.
 
                     The value type: ${typeof value}
@@ -8765,7 +8807,7 @@ function jsonParse(value) {
         if (!(error instanceof Error)) {
             throw error;
         }
-        throw new Error(spaceTrim((block) => `
+        throw new Error(spaceTrim$2((block) => `
                     ${block(error.message)}
 
                     The expected JSON text:
@@ -9236,14 +9278,14 @@ class MultipleLlmExecutionTools {
             if (description === undefined) {
                 return headLine;
             }
-            return spaceTrim((block) => `
+            return spaceTrim$2((block) => `
                         ${headLine}
 
                           ${ /* <- Note: Indenting the description: */block(description)}
                     `);
         })
             .join('\n\n');
-        return spaceTrim((block) => `
+        return spaceTrim$2((block) => `
                 Multiple LLM Providers:
 
                 ${block(innerModelsTitlesAndDescriptions)}
@@ -9334,7 +9376,7 @@ class MultipleLlmExecutionTools {
             //     1) OpenAI throw PipelineExecutionError: Parameter `{knowledge}` is not defined
             //     2) AnthropicClaude throw PipelineExecutionError: Parameter `{knowledge}` is not defined
             //     3) ...
-            spaceTrim((block) => `
+            spaceTrim$2((block) => `
                           All execution tools of ${this.title} failed:
 
                           ${block(errors
@@ -9347,7 +9389,7 @@ class MultipleLlmExecutionTools {
             throw new PipelineExecutionError(`You have not provided any \`LlmExecutionTools\` into ${this.title}`);
         }
         else {
-            throw new PipelineExecutionError(spaceTrim((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\`:
@@ -9380,7 +9422,7 @@ class MultipleLlmExecutionTools {
  */
 function joinLlmExecutionTools(title, ...llmExecutionTools) {
     if (llmExecutionTools.length === 0) {
-        const warningMessage = spaceTrim(`
+        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.
 
@@ -9552,14 +9594,14 @@ function $registeredScrapersMessage(availableScrapers) {
         return { ...metadata, isMetadataAviailable, isInstalled, isAvailableInTools };
     });
     if (metadata.length === 0) {
-        return spaceTrim(`
+        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((block) => `
+    return spaceTrim$2((block) => `
             Available scrapers are:
             ${block(metadata
         .map(({ packageName, className, isMetadataAviailable, isInstalled, mimeTypes, isAvailableInBrowser, isAvailableInTools, }, i) => {
@@ -9660,7 +9702,7 @@ const promptbookFetch = async (urlOrRequest, init) => {
         else if (urlOrRequest instanceof Request) {
             url = urlOrRequest.url;
         }
-        throw new PromptbookFetchError(spaceTrim((block) => `
+        throw new PromptbookFetchError(spaceTrim$2((block) => `
                     Can not fetch "${url}"
 
                     Fetch error:
@@ -9821,7 +9863,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((block) => `
+            throw new NotFoundError(spaceTrim$2((block) => `
                           Can not make source handler for file which does not exist:
 
                           File:
@@ -9914,7 +9956,7 @@ async function prepareKnowledgePieces(knowledgeSources, tools, options) {
                     // <- TODO: [🪓] Here should be no need for spreading new array, just `partialPieces = partialPiecesUnchecked`
                     break;
                 }
-                console.warn(spaceTrim((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:
@@ -9930,7 +9972,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((block) => `
+                throw new KnowledgeScrapeError(spaceTrim$2((block) => `
                             Cannot scrape knowledge
 
                             The source:
@@ -10424,7 +10466,7 @@ const CsvFormatParser = {
                 const { value, outputParameterName, settings, mapCallback, onProgress } = options;
                 const csv = csvParse(value, settings);
                 if (csv.errors.length !== 0) {
-                    throw new CsvFormatError(spaceTrim((block) => `
+                    throw new CsvFormatError(spaceTrim$2((block) => `
                                 CSV parsing error
 
                                 Error(s) from CSV parsing:
@@ -10469,7 +10511,7 @@ const CsvFormatParser = {
                 const { value, settings, mapCallback, onProgress } = options;
                 const csv = csvParse(value, settings);
                 if (csv.errors.length !== 0) {
-                    throw new CsvFormatError(spaceTrim((block) => `
+                    throw new CsvFormatError(spaceTrim$2((block) => `
                                 CSV parsing error
 
                                 Error(s) from CSV parsing:
@@ -10679,7 +10721,7 @@ function mapAvailableToExpectedParameters(options) {
     }
     // Phase 2️⃣: Non-matching mapping
     if (expectedParameterNames.size !== availableParametersNames.size) {
-        throw new PipelineExecutionError(spaceTrim((block) => `
+        throw new PipelineExecutionError(spaceTrim$2((block) => `
                     Can not map available parameters to expected parameters
 
                     Mapped parameters:
@@ -11269,7 +11311,7 @@ async function executeFormatSubvalues(options) {
         return /* not await */ executeAttempts({ ...options, logLlmCall });
     }
     if (jokerParameterNames.length !== 0) {
-        throw new UnexpectedError(spaceTrim((block) => `
+        throw new UnexpectedError(spaceTrim$2((block) => `
                     JOKER parameters are not supported together with FOREACH command
 
                     [🧞‍♀️] This should be prevented in \`validatePipeline\`
@@ -11282,7 +11324,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((block) => `
+        spaceTrim$2((block) => `
                     Unsupported format "${task.foreach.formatName}"
 
                     Available formats:
@@ -11299,7 +11341,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((block) => `
+        spaceTrim$2((block) => `
                     Unsupported subformat name "${task.foreach.subformatName}" for format "${task.foreach.formatName}"
 
                     Available subformat names for format "${formatDefinition.formatName}":
@@ -11339,7 +11381,7 @@ async function executeFormatSubvalues(options) {
                 if (!(error instanceof PipelineExecutionError)) {
                     throw error;
                 }
-                const highLevelError = new PipelineExecutionError(spaceTrim((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})
@@ -11363,7 +11405,7 @@ async function executeFormatSubvalues(options) {
                     ...options,
                     priority: priority + index,
                     parameters: allSubparameters,
-                    pipelineIdentification: spaceTrim((block) => `
+                    pipelineIdentification: spaceTrim$2((block) => `
                             ${block(pipelineIdentification)}
                             Subparameter index: ${index}
                         `),
@@ -11372,7 +11414,7 @@ async function executeFormatSubvalues(options) {
             }
             catch (error) {
                 if (length > BIG_DATASET_TRESHOLD) {
-                    console.error(spaceTrim((block) => `
+                    console.error(spaceTrim$2((block) => `
                               ${error.message}
 
                               This is error in FOREACH command when processing ${formatDefinition.formatName} ${subvalueParser.subvalueName} data (${index + 1}/${length})
@@ -12244,8 +12286,8 @@ class MarkdownScraper {
         knowledgeTextPieces.map(async (knowledgeTextPiece, i) => {
             // Note: These are just default values, they will be overwritten by the actual values:
             let name = `piece-${i}`;
-            let title = spaceTrim(knowledgeTextPiece.substring(0, 100));
-            const knowledgePieceContent = spaceTrim(knowledgeTextPiece);
+            let title = spaceTrim$2(knowledgeTextPiece.substring(0, 100));
+            const knowledgePieceContent = spaceTrim$2(knowledgeTextPiece);
             let keywords = [];
             const index = [];
             /*
@@ -12258,7 +12300,7 @@ class MarkdownScraper {
                     isCrashedOnError: true,
                 });
                 const { title: titleRaw = 'Untitled' } = titleResult.outputParameters;
-                title = spaceTrim(titleRaw) /* <- TODO: Maybe do in pipeline */;
+                title = spaceTrim$2(titleRaw) /* <- TODO: Maybe do in pipeline */;
                 name = titleToName(title);
                 // --- Keywords
                 const keywordsResult = await prepareKeywordsExecutor({ knowledgePieceContent }).asPromise({
@@ -12413,7 +12455,7 @@ class BoilerplateScraper {
             await $execCommand(command);
             // Note: [0]
             if (!(await isFileExisting(cacheFilehandler.filename, this.tools.fs))) {
-                throw new UnexpectedError(spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$2((block) => `
                     File that was supposed to be created by Pandoc does not exist for unknown reason
 
                     Expected file:
@@ -12577,7 +12619,7 @@ class DocumentScraper {
             await $execCommand(command);
             // Note: [0]
             if (!(await isFileExisting(cacheFilehandler.filename, this.tools.fs))) {
-                throw new UnexpectedError(spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$2((block) => `
                             File that was supposed to be created by Pandoc does not exist for unknown reason
 
                             Expected file:
@@ -12728,7 +12770,7 @@ class LegacyDocumentScraper {
             await $execCommand(command);
             const files = await readdir(documentSourceOutdirPathForLibreOffice);
             if (files.length !== 1) {
-                throw new UnexpectedError(spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$2((block) => `
                             Expected exactly 1 file in the LibreOffice output directory, got ${files.length}
 
                             The temporary folder:
@@ -12742,7 +12784,7 @@ class LegacyDocumentScraper {
             await rename(join(documentSourceOutdirPathForLibreOffice, file), cacheFilehandler.filename);
             await rmdir(documentSourceOutdirPathForLibreOffice);
             if (!(await isFileExisting(cacheFilehandler.filename, this.tools.fs))) {
-                throw new UnexpectedError(spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$2((block) => `
                             File that was supposed to be created by LibreOffice does not exist for unknown reason
 
                             Expected file:
@@ -13615,6 +13657,133 @@ class ActionCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * CLOSED commitment definition
+ *
+ * The CLOSED commitment specifies that the agent CANNOT be modified by conversation.
+ * It prevents the agent from learning from interactions and updating its source code.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * CLOSED
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class ClosedCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('CLOSED');
+    }
+    /**
+     * Short one-line description of CLOSED.
+     */
+    get description() {
+        return 'Prevent the agent from being modified by conversation.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🔒';
+    }
+    /**
+     * Markdown documentation for CLOSED commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # CLOSED
+
+            Specifies that the agent **cannot** be modified by conversation with it.
+            This means the agent will **not** learn from interactions and its source code will remain static during conversation.
+
+            By default (if not specified), agents are \`OPEN\` to modification.
+
+            > See also [OPEN](/docs/OPEN)
+
+            ## Example
+
+            \`\`\`book
+            CLOSED
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, _content) {
+        const updatedMetadata = {
+            ...requirements.metadata,
+            isClosed: true,
+        };
+        return {
+            ...requirements,
+            metadata: updatedMetadata,
+        };
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * COMPONENT commitment definition
+ *
+ * The COMPONENT commitment defines a UI component that the agent can render in the chat.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class ComponentCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('COMPONENT');
+    }
+    /**
+     * Short one-line description of COMPONENT.
+     */
+    get description() {
+        return 'Define a UI component that the agent can render in the chat.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🧩';
+    }
+    /**
+     * Markdown documentation for COMPONENT commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # COMPONENT
+
+            Defines a UI component that the agent can render in the chat.
+
+            ## Key aspects
+
+            - Tells the agent that a specific component is available.
+            - Provides syntax for using the component.
+
+            ## Example
+
+            \`\`\`book
+            COMPONENT Arrow
+            The agent should render an arrow component in the chat UI.
+            Syntax:
+            <Arrow direction="up" color="red" />
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        const trimmedContent = content.trim();
+        if (!trimmedContent) {
+            return requirements;
+        }
+        // Add component capability to the system message
+        const componentSection = `Component: ${trimmedContent}`;
+        return this.appendToSystemMessage(requirements, componentSection, '\n\n');
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * DELETE commitment definition
  *
@@ -13820,6 +13989,79 @@ class FormatCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * FROM commitment definition
+ *
+ * The FROM commitment tells the agent that its `agentSource` is inherited from another agent.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * FROM https://s6.ptbk.io/benjamin-white
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class FromCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor(type = 'FROM') {
+        super(type);
+    }
+    /**
+     * Short one-line description of FROM.
+     */
+    get description() {
+        return 'Inherit agent source from another agent.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🧬';
+    }
+    /**
+     * Markdown documentation for FROM commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # ${this.type}
+
+            Inherits agent source from another agent.
+
+            ## Examples
+
+            \`\`\`book
+            My AI Agent
+
+            FROM https://s6.ptbk.io/benjamin-white
+            RULE Speak only in English.
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        const trimmedContent = content.trim();
+        if (!trimmedContent) {
+            return requirements;
+        }
+        // Validate URL
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            const url = new URL(trimmedContent);
+            // TODO: Add more validation if needed (e.g. check for valid protocol)
+        }
+        catch (error) {
+            console.warn(`Invalid URL in FROM commitment: ${trimmedContent}`);
+            return requirements;
+        }
+        return {
+            ...requirements,
+            parentAgentUrl: trimmedContent,
+        };
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * GOAL commitment definition
  *
@@ -14028,6 +14270,77 @@ class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * LANGUAGE commitment definition
+ *
+ * The LANGUAGE/LANGUAGES commitment specifies the language(s) the agent should use in its responses.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * LANGUAGE English
+ * LANGUAGE French, English and Czech
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class LanguageCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor(type = 'LANGUAGE') {
+        super(type);
+    }
+    /**
+     * Short one-line description of LANGUAGE/LANGUAGES.
+     */
+    get description() {
+        return 'Specifies the language(s) the agent should use.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🌐';
+    }
+    /**
+     * Markdown documentation for LANGUAGE/LANGUAGES commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # ${this.type}
+
+            Specifies the language(s) the agent should use in its responses.
+            This is a specialized variation of the RULE commitment focused on language constraints.
+
+            ## Examples
+
+            \`\`\`book
+            Paul Smith & Associés
+
+            PERSONA You are a company lawyer.
+            LANGUAGE French, English and Czech
+            \`\`\`
+
+            \`\`\`book
+            Customer Support
+
+            PERSONA You are a customer support agent.
+            LANGUAGE English
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        const trimmedContent = content.trim();
+        if (!trimmedContent) {
+            return requirements;
+        }
+        // Add language rule to the system message
+        const languageSection = `Language: ${trimmedContent}`;
+        return this.appendToSystemMessage(requirements, languageSection, '\n\n');
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * MEMORY commitment definition
  *
@@ -14612,6 +14925,12 @@ class MetaCommitmentDefinition extends BaseCommitmentDefinition {
  * META COLOR #00ff00
  * ```
  *
+ * You can also specify multiple colors separated by comma:
+ *
+ * ```book
+ * META COLOR #ff0000, #00ff00, #0000ff
+ * ```
+ *
  * @private [🪔] Maybe export the commitments through some package
  */
 class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
@@ -14622,7 +14941,7 @@ class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
      * Short one-line description of META COLOR.
      */
     get description() {
-        return "Set the agent's accent color.";
+        return "Set the agent's accent color or gradient.";
     }
     /**
      * Icon for this commitment.
@@ -14637,7 +14956,7 @@ class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
         return spaceTrim$1(`
             # META COLOR
 
-            Sets the agent's accent color.
+            Sets the agent's accent color or gradient.
 
             ## Key aspects
 
@@ -14645,6 +14964,7 @@ class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
             - Only one \`META COLOR\` should be used per agent.
             - If multiple are specified, the last one takes precedence.
             - Used for visual representation in user interfaces.
+            - Can specify multiple colors separated by comma to create a gradient.
 
             ## Examples
 
@@ -14661,6 +14981,13 @@ class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
             META COLOR #e74c3c
             PERSONA You are a creative and inspiring assistant
             \`\`\`
+
+            \`\`\`book
+            Gradient Agent
+
+            META COLOR #ff0000, #00ff00, #0000ff
+            PERSONA You are a colorful agent
+            \`\`\`
         `);
     }
     applyToAgentModelRequirements(requirements, content) {
@@ -14683,84 +15010,82 @@ class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
  */
 
 /**
- * META IMAGE commitment definition
+ * META FONT commitment definition
  *
- * The META IMAGE commitment sets the agent's avatar/profile image URL.
+ * The META FONT commitment sets the agent's font.
  * This commitment is special because it doesn't affect the system message,
  * but is handled separately in the parsing logic.
  *
  * Example usage in agent source:
  *
  * ```book
- * META IMAGE https://example.com/avatar.jpg
- * META IMAGE /assets/agent-avatar.png
+ * META FONT Poppins, Arial, sans-serif
+ * META FONT Roboto
  * ```
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
+class MetaFontCommitmentDefinition extends BaseCommitmentDefinition {
     constructor() {
-        super('META IMAGE', ['IMAGE']);
+        super('META FONT', ['FONT']);
     }
     /**
-     * Short one-line description of META IMAGE.
+     * Short one-line description of META FONT.
      */
     get description() {
-        return "Set the agent's profile image URL.";
+        return "Set the agent's font.";
     }
     /**
      * Icon for this commitment.
      */
     get icon() {
-        return '🖼️';
+        return '🔤';
     }
     /**
-     * Markdown documentation for META IMAGE commitment.
+     * Markdown documentation for META FONT commitment.
      */
     get documentation() {
         return spaceTrim$1(`
-            # META IMAGE
+            # META FONT
 
-            Sets the agent's avatar/profile image URL.
+            Sets the agent's font.
 
             ## Key aspects
 
             - Does not modify the agent's behavior or responses.
-            - Only one \`META IMAGE\` should be used per agent.
+            - Only one \`META FONT\` should be used per agent.
             - If multiple are specified, the last one takes precedence.
             - Used for visual representation in user interfaces.
+            - Supports Google Fonts.
 
             ## Examples
 
             \`\`\`book
-            Professional Assistant
+            Modern Assistant
 
-            META IMAGE https://example.com/professional-avatar.jpg
-            PERSONA You are a professional business assistant
-            STYLE Maintain a formal and courteous tone
+            META FONT Poppins, Arial, sans-serif
+            PERSONA You are a modern assistant
             \`\`\`
 
             \`\`\`book
-            Creative Helper
+            Classic Helper
 
-            META IMAGE /assets/creative-bot-avatar.png
-            PERSONA You are a creative and inspiring assistant
-            STYLE Be enthusiastic and encouraging
-            ACTION Can help with brainstorming and ideation
+            META FONT Times New Roman
+            PERSONA You are a classic helper
             \`\`\`
         `);
     }
     applyToAgentModelRequirements(requirements, content) {
-        // META IMAGE doesn't modify the system message or model requirements
-        // It's handled separately in the parsing logic for profile image extraction
+        // META FONT doesn't modify the system message or model requirements
+        // It's handled separately in the parsing logic
         // This method exists for consistency with the CommitmentDefinition interface
         return requirements;
     }
     /**
-     * Extracts the profile image URL from the content
+     * Extracts the font from the content
      * This is used by the parsing logic
      */
-    extractProfileImageUrl(content) {
+    extractProfileFont(content) {
         const trimmedContent = content.trim();
         return trimmedContent || null;
     }
@@ -14770,10 +15095,206 @@ class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
  */
 
 /**
- * MODEL commitment definition
+ * META IMAGE commitment definition
  *
- * The MODEL commitment specifies which AI model to use and can also set
- * model-specific parameters like temperature, topP, topK, and maxTokens.
+ * The META IMAGE commitment sets the agent's avatar/profile image URL.
+ * This commitment is special because it doesn't affect the system message,
+ * but is handled separately in the parsing logic.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * META IMAGE https://example.com/avatar.jpg
+ * META IMAGE /assets/agent-avatar.png
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('META IMAGE', ['IMAGE']);
+    }
+    /**
+     * Short one-line description of META IMAGE.
+     */
+    get description() {
+        return "Set the agent's profile image URL.";
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🖼️';
+    }
+    /**
+     * Markdown documentation for META IMAGE commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # META IMAGE
+
+            Sets the agent's avatar/profile image URL.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - Only one \`META IMAGE\` should be used per agent.
+            - If multiple are specified, the last one takes precedence.
+            - Used for visual representation in user interfaces.
+
+            ## Examples
+
+            \`\`\`book
+            Professional Assistant
+
+            META IMAGE https://example.com/professional-avatar.jpg
+            PERSONA You are a professional business assistant
+            STYLE Maintain a formal and courteous tone
+            \`\`\`
+
+            \`\`\`book
+            Creative Helper
+
+            META IMAGE /assets/creative-bot-avatar.png
+            PERSONA You are a creative and inspiring assistant
+            STYLE Be enthusiastic and encouraging
+            ACTION Can help with brainstorming and ideation
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // META IMAGE doesn't modify the system message or model requirements
+        // It's handled separately in the parsing logic for profile image extraction
+        // This method exists for consistency with the CommitmentDefinition interface
+        return requirements;
+    }
+    /**
+     * Extracts the profile image URL from the content
+     * This is used by the parsing logic
+     */
+    extractProfileImageUrl(content) {
+        const trimmedContent = content.trim();
+        return trimmedContent || null;
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * META LINK commitment definition
+ *
+ * The `META LINK` commitment represents the link to the person from whom the agent is created.
+ * This commitment is special because it doesn't affect the system message,
+ * but is handled separately in the parsing logic for profile display.
+ *
+ * Example usage in agent source:
+ *
+ * ```
+ * META LINK https://twitter.com/username
+ * META LINK https://linkedin.com/in/profile
+ * META LINK https://github.com/username
+ * ```
+ *
+ * Multiple `META LINK` commitments can be used when there are multiple sources:
+ *
+ * ```book
+ * META LINK https://twitter.com/username
+ * META LINK https://linkedin.com/in/profile
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class MetaLinkCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('META LINK');
+    }
+    /**
+     * Short one-line description of META LINK.
+     */
+    get description() {
+        return 'Provide profile/source links for the person the agent models.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🔗';
+    }
+    /**
+     * Markdown documentation for META LINK commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # META LINK
+
+            Represents a profile or source link for the person the agent is modeled after.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - Multiple \`META LINK\` commitments can be used for different social profiles.
+            - Used for attribution and crediting the original person.
+            - Displayed in user interfaces for transparency.
+
+            ## Examples
+
+            \`\`\`book
+            Expert Consultant
+
+            META LINK https://twitter.com/expertname
+            META LINK https://linkedin.com/in/expertprofile
+            PERSONA You are Dr. Smith, a renowned expert in artificial intelligence
+            KNOWLEDGE Extensive background in machine learning and neural networks
+            \`\`\`
+
+            \`\`\`book
+            Open Source Developer
+
+            META LINK https://github.com/developer
+            META LINK https://twitter.com/devhandle
+            PERSONA You are an experienced open source developer
+            ACTION Can help with code reviews and architecture decisions
+            STYLE Be direct and technical in explanations
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // META LINK doesn't modify the system message or model requirements
+        // It's handled separately in the parsing logic for profile link extraction
+        // This method exists for consistency with the CommitmentDefinition interface
+        return requirements;
+    }
+    /**
+     * Extracts the profile link URL from the content
+     * This is used by the parsing logic
+     */
+    extractProfileLinkUrl(content) {
+        const trimmedContent = content.trim();
+        return trimmedContent || null;
+    }
+    /**
+     * Validates if the provided content is a valid URL
+     */
+    isValidUrl(content) {
+        try {
+            new URL(content.trim());
+            return true;
+        }
+        catch (_a) {
+            return false;
+        }
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * MODEL commitment definition
+ *
+ * The MODEL commitment specifies which AI model to use and can also set
+ * model-specific parameters like temperature, topP, topK, and maxTokens.
  *
  * Supports multiple syntax variations:
  *
@@ -15120,6 +15641,74 @@ class NoteCommitmentDefinition extends BaseCommitmentDefinition {
  * [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * OPEN commitment definition
+ *
+ * The OPEN commitment specifies that the agent can be modified by conversation.
+ * This is the default behavior.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * OPEN
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class OpenCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('OPEN');
+    }
+    /**
+     * Short one-line description of OPEN.
+     */
+    get description() {
+        return 'Allow the agent to be modified by conversation (default).';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🔓';
+    }
+    /**
+     * Markdown documentation for OPEN commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # OPEN
+
+            Specifies that the agent can be modified by conversation with it.
+            This means the agent will learn from interactions and update its source code.
+            
+            This is the default behavior if neither \`OPEN\` nor \`CLOSED\` is specified.
+
+            > See also [CLOSED](/docs/CLOSED)
+
+            ## Example
+
+            \`\`\`book
+            OPEN
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, _content) {
+        // Since OPEN is default, we can just ensure isClosed is false
+        // But to be explicit we can set it
+        const updatedMetadata = {
+            ...requirements.metadata,
+            isClosed: false,
+        };
+        return {
+            ...requirements,
+            metadata: updatedMetadata,
+        };
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * PERSONA commitment definition
  *
@@ -15630,6 +16219,389 @@ class StyleCommitmentDefinition extends BaseCommitmentDefinition {
  * [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * USE commitment definition
+ *
+ * The USE commitment indicates that the agent should utilize specific tools or capabilities
+ * to access and interact with external systems when necessary.
+ *
+ * Supported USE types:
+ * - USE BROWSER: Enables the agent to use a web browser tool
+ * - USE SEARCH ENGINE (future): Enables search engine access
+ * - USE FILE SYSTEM (future): Enables file system operations
+ * - USE MCP (future): Enables MCP server connections
+ *
+ * The content following the USE commitment is ignored (similar to NOTE).
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * USE BROWSER
+ * USE SEARCH ENGINE
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class UseCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('USE');
+    }
+    /**
+     * Short one-line description of USE commitments.
+     */
+    get description() {
+        return 'Enable the agent to use specific tools or capabilities (BROWSER, SEARCH ENGINE, etc.).';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🔧';
+    }
+    /**
+     * Markdown documentation for USE commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # USE
+
+            Enables the agent to use specific tools or capabilities for interacting with external systems.
+
+            ## Supported USE types
+
+            - **USE BROWSER** - Enables the agent to use a web browser tool to access and retrieve information from the internet
+            - **USE SEARCH ENGINE** (future) - Enables search engine access
+            - **USE FILE SYSTEM** (future) - Enables file system operations
+            - **USE MCP** (future) - Enables MCP server connections
+
+            ## Key aspects
+
+            - The content following the USE commitment is ignored (similar to NOTE)
+            - Multiple USE commitments can be specified to enable multiple capabilities
+            - The actual tool usage is handled by the agent runtime
+
+            ## Examples
+
+            ### Basic browser usage
+
+            \`\`\`book
+            Research Assistant
+
+            PERSONA You are a helpful research assistant
+            USE BROWSER
+            KNOWLEDGE Can search the web for up-to-date information
+            \`\`\`
+
+            ### Multiple tools
+
+            \`\`\`book
+            Data Analyst
+
+            PERSONA You are a data analyst assistant
+            USE BROWSER
+            USE FILE SYSTEM
+            ACTION Can analyze data from various sources
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // USE commitments don't modify the system message or model requirements directly
+        // They are handled separately in the parsing logic for capability extraction
+        // This method exists for consistency with the CommitmentDefinition interface
+        return requirements;
+    }
+    /**
+     * Extracts the tool type from the USE commitment
+     * This is used by the parsing logic
+     */
+    extractToolType(content) {
+        var _a, _b;
+        const trimmedContent = content.trim();
+        // The tool type is the first word after USE (already stripped)
+        const match = trimmedContent.match(/^(\w+)/);
+        return (_b = (_a = match === null || match === void 0 ? void 0 : match[1]) === null || _a === void 0 ? void 0 : _a.toUpperCase()) !== null && _b !== void 0 ? _b : null;
+    }
+    /**
+     * Checks if this is a known USE type
+     */
+    isKnownUseType(useType) {
+        const knownTypes = ['BROWSER', 'SEARCH ENGINE', 'FILE SYSTEM', 'MCP'];
+        return knownTypes.includes(useType.toUpperCase());
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * USE BROWSER commitment definition
+ *
+ * The `USE BROWSER` commitment indicates that the agent should utilize a web browser tool
+ * to access and retrieve up-to-date information from the internet when necessary.
+ *
+ * The content following `USE BROWSER` is ignored (similar to NOTE).
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * USE BROWSER
+ * USE BROWSER This will be ignored
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class UseBrowserCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('USE BROWSER', ['BROWSER']);
+    }
+    /**
+     * Short one-line description of USE BROWSER.
+     */
+    get description() {
+        return 'Enable the agent to use a web browser tool for accessing internet information.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🌐';
+    }
+    /**
+     * Markdown documentation for USE BROWSER commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # USE BROWSER
+
+            Enables the agent to use a web browser tool to access and retrieve up-to-date information from the internet.
+
+            ## Key aspects
+
+            - The content following \`USE BROWSER\` is ignored (similar to NOTE)
+            - The actual browser tool usage is handled by the agent runtime
+            - Allows the agent to fetch current information from websites
+            - Useful for research tasks, fact-checking, and accessing dynamic content
+
+            ## Examples
+
+            \`\`\`book
+            Research Assistant
+
+            PERSONA You are a helpful research assistant specialized in finding current information
+            USE BROWSER
+            RULE Always cite your sources when providing information from the web
+            \`\`\`
+
+            \`\`\`book
+            News Analyst
+
+            PERSONA You are a news analyst who stays up-to-date with current events
+            USE BROWSER
+            STYLE Present news in a balanced and objective manner
+            ACTION Can search for and summarize news articles
+            \`\`\`
+
+            \`\`\`book
+            Company Lawyer
+
+            PERSONA You are a company lawyer providing legal advice
+            USE BROWSER
+            KNOWLEDGE Corporate law and legal procedures
+            RULE Always recommend consulting with a licensed attorney for specific legal matters
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // We simply mark that browser capability is enabled in metadata
+        // Get existing metadata
+        const existingMetadata = requirements.metadata || {};
+        // Get existing tools array or create new one
+        const existingTools = existingMetadata.tools || [];
+        // Add 'browser' to tools if not already present
+        const updatedTools = existingTools.includes('browser') ? existingTools : [...existingTools, 'browser'];
+        // Return requirements with updated metadata
+        return {
+            ...requirements,
+            metadata: {
+                ...existingMetadata,
+                tools: updatedTools,
+                useBrowser: true,
+            },
+        };
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * USE MCP commitment definition
+ *
+ * The `USE MCP` commitment allows to specify an MCP server URL which the agent will connect to
+ * for retrieving additional instructions and actions.
+ *
+ * The content following `USE MCP` is the URL of the MCP server.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * USE MCP http://mcp-server-url.com
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class UseMcpCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('USE MCP', ['MCP']);
+    }
+    /**
+     * Short one-line description of USE MCP.
+     */
+    get description() {
+        return 'Connects the agent to an external MCP server for additional capabilities.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🔌';
+    }
+    /**
+     * Markdown documentation for USE MCP commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # USE MCP
+
+            Connects the agent to an external Model Context Protocol (MCP) server.
+
+            ## Key aspects
+
+            - The content following \`USE MCP\` must be a valid URL
+            - Multiple MCP servers can be connected by using multiple \`USE MCP\` commitments
+            - The agent will have access to tools and resources provided by the MCP server
+
+            ## Example
+
+            \`\`\`book
+            Company Lawyer
+
+            PERSONA You are a company lawyer.
+            USE MCP http://legal-db.example.com
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        const mcpServerUrl = content.trim();
+        if (!mcpServerUrl) {
+            return requirements;
+        }
+        const existingMcpServers = requirements.mcpServers || [];
+        // Avoid duplicates
+        if (existingMcpServers.includes(mcpServerUrl)) {
+            return requirements;
+        }
+        return {
+            ...requirements,
+            mcpServers: [...existingMcpServers, mcpServerUrl],
+        };
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * USE SEARCH ENGINE commitment definition
+ *
+ * The `USE SEARCH ENGINE` commitment indicates that the agent should utilize a search engine tool
+ * to access and retrieve up-to-date information from the internet when necessary.
+ *
+ * The content following `USE SEARCH ENGINE` is ignored (similar to NOTE).
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * USE SEARCH ENGINE
+ * USE SEARCH ENGINE This will be ignored
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('USE SEARCH ENGINE', ['SEARCH ENGINE', 'SEARCH']);
+    }
+    /**
+     * Short one-line description of USE SEARCH ENGINE.
+     */
+    get description() {
+        return 'Enable the agent to use a search engine tool for accessing internet information.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '🔍';
+    }
+    /**
+     * Markdown documentation for USE SEARCH ENGINE commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # USE SEARCH ENGINE
+
+            Enables the agent to use a search engine tool to access and retrieve up-to-date information from the internet.
+
+            ## Key aspects
+
+            - The content following \`USE SEARCH ENGINE\` is ignored (similar to NOTE)
+            - The actual search engine tool usage is handled by the agent runtime
+            - Allows the agent to search for current information from the web
+            - Useful for research tasks, finding facts, and accessing dynamic content
+
+            ## Examples
+
+            \`\`\`book
+            Research Assistant
+
+            PERSONA You are a helpful research assistant specialized in finding current information
+            USE SEARCH ENGINE
+            RULE Always cite your sources when providing information from the web
+            \`\`\`
+
+            \`\`\`book
+            Fact Checker
+
+            PERSONA You are a fact checker
+            USE SEARCH ENGINE
+            ACTION Search for claims and verify them against reliable sources
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // We simply mark that search engine capability is enabled in metadata
+        // Get existing metadata
+        const existingMetadata = requirements.metadata || {};
+        // Get existing tools array or create new one
+        const existingTools = existingMetadata.tools || [];
+        // Add 'search-engine' to tools if not already present
+        const updatedTools = existingTools.includes('search-engine') ? existingTools : [...existingTools, 'search-engine'];
+        // Return requirements with updated metadata
+        return {
+            ...requirements,
+            metadata: {
+                ...existingMetadata,
+                tools: updatedTools,
+                useSearchEngine: true,
+            },
+        };
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * Placeholder commitment definition for commitments that are not yet implemented
  *
@@ -15716,16 +16688,22 @@ const COMMITMENT_REGISTRY = [
     new StyleCommitmentDefinition('STYLES'),
     new RuleCommitmentDefinition('RULE'),
     new RuleCommitmentDefinition('RULES'),
+    new LanguageCommitmentDefinition('LANGUAGE'),
+    new LanguageCommitmentDefinition('LANGUAGES'),
     new SampleCommitmentDefinition('SAMPLE'),
     new SampleCommitmentDefinition('EXAMPLE'),
     new FormatCommitmentDefinition('FORMAT'),
     new FormatCommitmentDefinition('FORMATS'),
+    new FromCommitmentDefinition('FROM'),
     new ModelCommitmentDefinition('MODEL'),
     new ModelCommitmentDefinition('MODELS'),
     new ActionCommitmentDefinition('ACTION'),
     new ActionCommitmentDefinition('ACTIONS'),
+    new ComponentCommitmentDefinition(),
     new MetaImageCommitmentDefinition(),
     new MetaColorCommitmentDefinition(),
+    new MetaFontCommitmentDefinition(),
+    new MetaLinkCommitmentDefinition(),
     new MetaCommitmentDefinition(),
     new NoteCommitmentDefinition('NOTE'),
     new NoteCommitmentDefinition('NOTES'),
@@ -15744,6 +16722,12 @@ const COMMITMENT_REGISTRY = [
     new DeleteCommitmentDefinition('CANCEL'),
     new DeleteCommitmentDefinition('DISCARD'),
     new DeleteCommitmentDefinition('REMOVE'),
+    new OpenCommitmentDefinition(),
+    new ClosedCommitmentDefinition(),
+    new UseBrowserCommitmentDefinition(),
+    new UseSearchEngineCommitmentDefinition(),
+    new UseMcpCommitmentDefinition(),
+    new UseCommitmentDefinition(),
     // Not yet implemented commitments (using placeholder)
     new NotYetImplementedCommitmentDefinition('EXPECT'),
     new NotYetImplementedCommitmentDefinition('BEHAVIOUR'),
@@ -15801,6 +16785,11 @@ function createBasicAgentModelRequirements(agentName) {
  * TODO: [🐤] Deduplicate `AgentModelRequirements` and `ModelRequirements` model requirements
  */
 
+/**
+ * Regex pattern to match horizontal lines (markdown thematic breaks)
+ * Matches 3 or more hyphens, underscores, or asterisks (with optional spaces between)
+ */
+const HORIZONTAL_LINE_PATTERN = /^[\s]*[-_*][\s]*[-_*][\s]*[-_*][\s]*[-_*]*[\s]*$/;
 /**
  * Parses agent source using the new commitment system with multiline support
  * This function replaces the hardcoded commitment parsing in the original parseAgentSource
@@ -15863,6 +16852,24 @@ function parseAgentSourceWithCommitments(agentSource) {
                 break;
             }
         }
+        // Check if this is a horizontal line (ends any current commitment)
+        const isHorizontalLine = HORIZONTAL_LINE_PATTERN.test(line);
+        if (isHorizontalLine) {
+            // Save the current commitment if it exists
+            if (currentCommitment) {
+                const fullContent = currentCommitment.contentLines.join('\n');
+                commitments.push({
+                    type: currentCommitment.type,
+                    content: spaceTrim$1(fullContent),
+                    originalLine: currentCommitment.originalStartLine,
+                    lineNumber: currentCommitment.startLineNumber,
+                });
+                currentCommitment = null;
+            }
+            // Add horizontal line to non-commitment lines
+            nonCommitmentLines.push(line);
+            continue;
+        }
         if (!foundNewCommitment) {
             if (currentCommitment) {
                 // This line belongs to the current commitment
@@ -16168,7 +17175,7 @@ function generatePlaceholderAgentProfileImageUrl(agentName) {
  * @public exported from `@promptbook/utils`
  */
 function computeHash(value) {
-    return SHA256(hexEncoder.parse(spaceTrim(valueToString(value)))).toString( /* hex */);
+    return SHA256(hexEncoder.parse(spaceTrim$2(valueToString(value)))).toString( /* hex */);
 }
 /**
  * TODO: [🥬][🥬] Use this ACRY
@@ -16506,7 +17513,7 @@ function isValidJavascriptName(javascriptName) {
  * @public exported from `@promptbook/core`
  */
 function normalizeAgentName(rawAgentName) {
-    return titleToName(spaceTrim(rawAgentName));
+    return titleToName(spaceTrim$2(rawAgentName));
 }
 
 /**
@@ -16558,15 +17565,21 @@ function parseAgentSource(agentSource) {
     const links = [];
     for (const commitment of parseResult.commitments) {
         if (commitment.type === 'META LINK') {
-            links.push(spaceTrim(commitment.content));
+            const linkValue = spaceTrim$2(commitment.content);
+            links.push(linkValue);
+            meta.link = linkValue;
             continue;
         }
         if (commitment.type === 'META IMAGE') {
-            meta.image = spaceTrim(commitment.content);
+            meta.image = spaceTrim$2(commitment.content);
             continue;
         }
         if (commitment.type === 'META COLOR') {
-            meta.color = spaceTrim(commitment.content);
+            meta.color = spaceTrim$2(commitment.content);
+            continue;
+        }
+        if (commitment.type === 'META FONT') {
+            meta.font = spaceTrim$2(commitment.content);
             continue;
         }
         if (commitment.type !== 'META') {
@@ -16575,10 +17588,10 @@ function parseAgentSource(agentSource) {
         // Parse META commitments - format is "META TYPE content"
         const metaTypeRaw = commitment.content.split(' ')[0] || 'NONE';
         if (metaTypeRaw === 'LINK') {
-            links.push(spaceTrim(commitment.content.substring(metaTypeRaw.length)));
+            links.push(spaceTrim$2(commitment.content.substring(metaTypeRaw.length)));
         }
         const metaType = normalizeTo_camelCase(metaTypeRaw);
-        meta[metaType] = spaceTrim(commitment.content.substring(metaTypeRaw.length));
+        meta[metaType] = spaceTrim$2(commitment.content.substring(metaTypeRaw.length));
     }
     // Generate gravatar fallback if no meta image specified
     if (!meta.image) {
@@ -16730,7 +17743,7 @@ const OpenAiSdkTranspiler = {
         });
         const KNOWLEDGE_THRESHOLD = 1000;
         if (directKnowledge.join('\n').length > KNOWLEDGE_THRESHOLD || knowledgeSources.length > 0) {
-            return spaceTrim((block) => `
+            return spaceTrim$2((block) => `
                     #!/usr/bin/env node
 
                     import * as dotenv from 'dotenv';
@@ -16795,7 +17808,7 @@ const OpenAiSdkTranspiler = {
                         }
 
                         const userMessage = spaceTrim(\`
-                            ${block(spaceTrim(`
+                            ${block(spaceTrim$2(`
                                     Here is some additional context to help you answer the question:
                                     \${context}
 
@@ -16840,7 +17853,7 @@ const OpenAiSdkTranspiler = {
                     })();
                 `);
         }
-        const source = spaceTrim((block) => `
+        const source = spaceTrim$2((block) => `
 
                 #!/usr/bin/env node
 
@@ -17251,13 +18264,13 @@ function $registeredLlmToolsMessage() {
     });
     const usedEnvMessage = $usedEnvFilename === null ? `Unknown \`.env\` file` : `Used \`.env\` file:\n${$usedEnvFilename}`;
     if (metadata.length === 0) {
-        return spaceTrim((block) => `
+        return spaceTrim$2((block) => `
                 No LLM providers are available.
 
                 ${block(usedEnvMessage)}
           `);
     }
-    return spaceTrim((block) => `
+    return spaceTrim$2((block) => `
 
             ${block(usedEnvMessage)}
 
@@ -17303,7 +18316,7 @@ function $registeredLlmToolsMessage() {
                 morePieces.push(`Not configured`); // <- Note: Can not be configured via environment variables
             }
         }
-        let providerMessage = spaceTrim(`
+        let providerMessage = spaceTrim$2(`
                                 ${i + 1}) **${title}** \`${className}\` from \`${packageName}\`
                                     ${morePieces.join('; ')}
                             `);
@@ -17437,7 +18450,7 @@ class $EnvStorage {
             .filter((line) => !line.startsWith(`# ${GENERATOR_WARNING_IN_ENV}`)) // Remove GENERATOR_WARNING_IN_ENV
             .filter((line) => !line.startsWith(`${transformedKey}=`)) // Remove existing key if present
             .join('\n');
-        const newEnvContent = spaceTrim((block) => `
+        const newEnvContent = spaceTrim$2((block) => `
                 ${block(updatedEnvContent)}
 
                 # ${GENERATOR_WARNING_IN_ENV}
@@ -17466,7 +18479,7 @@ class $EnvStorage {
  */
 function stringifyPipelineJson(pipeline) {
     if (!isSerializableAsJson(pipeline)) {
-        throw new UnexpectedError(spaceTrim(`
+        throw new UnexpectedError(spaceTrim$2(`
                 Cannot stringify the pipeline, because it is not serializable as JSON
 
                 There can be multiple reasons:
@@ -17666,7 +18679,7 @@ function cacheLlmTools(llmTools, options = {}) {
         let normalizedContent = content;
         normalizedContent = normalizedContent.replace(/\s+/g, ' ');
         normalizedContent = normalizedContent.split('\r\n').join('\n');
-        normalizedContent = spaceTrim(normalizedContent);
+        normalizedContent = spaceTrim$2(normalizedContent);
         // Note: Do not need to save everything in the cache, just the relevant parameters
         const relevantParameterNames = extractParameterNames(content);
         const relevantParameters = Object.fromEntries(Object.entries(parameters).filter(([key]) => relevantParameterNames.has(key)));
@@ -17855,7 +18868,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((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'}
 
@@ -17923,14 +18936,14 @@ async function $provideLlmToolsFromEnv(options = {}) {
     const configuration = await $provideLlmToolsConfigurationFromEnv();
     if (configuration.length === 0) {
         if ($llmToolsMetadataRegister.list().length === 0) {
-            throw new UnexpectedError(spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$2((block) => `
                         No LLM tools registered, this is probably a bug in the Promptbook library
 
                         ${block($registeredLlmToolsMessage())}}
                     `));
         }
         // TODO: [🥃]
-        throw new Error(spaceTrim((block) => `
+        throw new Error(spaceTrim$2((block) => `
                     No LLM tools found in the environment
 
                     ${block($registeredLlmToolsMessage())}}
@@ -18068,7 +19081,7 @@ async function $provideScrapersForNode(tools, options) {
 function extractOneBlockFromMarkdown(markdown) {
     const codeBlocks = extractAllBlocksFromMarkdown(markdown);
     if (codeBlocks.length !== 1) {
-        throw new ParseError(spaceTrim((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'))}
@@ -18177,8 +19190,8 @@ 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$1 = (_) => spaceTrim(_);
-        $preserve(spaceTrim$1);
+        const spaceTrim = (_) => spaceTrim$2(_);
+        $preserve(spaceTrim);
         const removeQuotes$1 = removeQuotes;
         $preserve(removeQuotes$1);
         const unwrapResult$1 = unwrapResult;
@@ -18231,7 +19244,7 @@ class JavascriptEvalExecutionTools {
         // TODO: DRY [🍯]
         const buildinFunctions = {
             // TODO: [🍯] DRY all these functions across the file
-            spaceTrim: spaceTrim$1,
+            spaceTrim,
             removeQuotes: removeQuotes$1,
             unwrapResult: unwrapResult$1,
             trimEndOfCodeBlock: trimEndOfCodeBlock$1,
@@ -18268,7 +19281,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((block) => `
+        const statementToEvaluate = spaceTrim$2((block) => `
 
                 // Build-in functions:
                 ${block(buildinFunctionsStatement)}
@@ -18283,7 +19296,7 @@ class JavascriptEvalExecutionTools {
                 (()=>{ ${script} })()
             `);
         if (this.options.isVerbose) {
-            console.info(spaceTrim((block) => `
+            console.info(spaceTrim$2((block) => `
                         🚀 Evaluating ${scriptLanguage} script:
 
                         ${block(statementToEvaluate)}`));
@@ -18305,7 +19318,7 @@ class JavascriptEvalExecutionTools {
                       To:   [PipelineExecutionError: Parameter `{thing}` is not defined],
                 */
                 if (!statementToEvaluate.includes(undefinedName + '(')) {
-                    throw new PipelineExecutionError(spaceTrim((block) => `
+                    throw new PipelineExecutionError(spaceTrim$2((block) => `
 
                                 Parameter \`{${undefinedName}}\` is not defined
 
@@ -18327,7 +19340,7 @@ class JavascriptEvalExecutionTools {
                             `));
                 }
                 else {
-                    throw new PipelineExecutionError(spaceTrim((block) => `
+                    throw new PipelineExecutionError(spaceTrim$2((block) => `
                                   Function ${undefinedName}() is not defined
 
                                   -  Make sure that the function is one of built-in functions
@@ -18466,7 +19479,7 @@ const knowledgeCommandParser = {
      */
     parse(input) {
         const { args } = input;
-        const knowledgeSourceContent = spaceTrim(args[0] || '');
+        const knowledgeSourceContent = spaceTrim$2(args[0] || '');
         if (knowledgeSourceContent === '') {
             throw new ParseError(`Source is not defined`);
         }
@@ -18610,7 +19623,7 @@ const sectionCommandParser = {
         normalized = normalized.split('DIALOGUE').join('DIALOG');
         const taskTypes = SectionTypes.filter((sectionType) => normalized.includes(sectionType.split('_TASK').join('')));
         if (taskTypes.length !== 1) {
-            throw new ParseError(spaceTrim((block) => `
+            throw new ParseError(spaceTrim$2((block) => `
                         Unknown section type "${normalized}"
 
                         Supported section types are:
@@ -18630,7 +19643,7 @@ const sectionCommandParser = {
      */
     $applyToTaskJson(command, $taskJson, $pipelineJson) {
         if ($taskJson.isSectionTypeSet === true) {
-            throw new ParseError(spaceTrim(`
+            throw new ParseError(spaceTrim$2(`
                     Section type is already defined in the section.
                     It can be defined only once.
                 `));
@@ -18910,7 +19923,7 @@ const expectCommandParser = {
     /**
      * Description of the FORMAT command
      */
-    description: spaceTrim(`
+    description: spaceTrim$2(`
         Expect command describes the desired output of the task *(after post-processing)*
         It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs or some other shape of the output.
     `),
@@ -18984,7 +19997,7 @@ const expectCommandParser = {
         }
         catch (error) {
             assertsError(error);
-            throw new ParseError(spaceTrim((block) => `
+            throw new ParseError(spaceTrim$2((block) => `
                             Invalid FORMAT command
                             ${block(error.message)}:
                         `));
@@ -19096,7 +20109,7 @@ function validateParameterName(parameterName) {
         if (!(error instanceof ParseError)) {
             throw error;
         }
-        throw new ParseError(spaceTrim((block) => `
+        throw new ParseError(spaceTrim$2((block) => `
                     ${block(error.message)}
 
                     Tried to validate parameter name:
@@ -19155,7 +20168,7 @@ const foreachCommandParser = {
         const assignSign = args[3];
         const formatDefinition = FORMAT_DEFINITIONS.find((formatDefinition) => [formatDefinition.formatName, ...(formatDefinition.aliases || [])].includes(formatName));
         if (formatDefinition === undefined) {
-            throw new ParseError(spaceTrim((block) => `
+            throw new ParseError(spaceTrim$2((block) => `
                         Unsupported format "${formatName}"
 
                         Available formats:
@@ -19167,7 +20180,7 @@ const foreachCommandParser = {
         }
         const subvalueParser = formatDefinition.subvalueParsers.find((subvalueParser) => [subvalueParser.subvalueName, ...(subvalueParser.aliases || [])].includes(subformatName));
         if (subvalueParser === undefined) {
-            throw new ParseError(spaceTrim((block) => `
+            throw new ParseError(spaceTrim$2((block) => `
                         Unsupported subformat name "${subformatName}" for format "${formatName}"
 
                         Available subformat names for format "${formatDefinition.formatName}":
@@ -19215,7 +20228,7 @@ const foreachCommandParser = {
                 outputSubparameterName = 'newLine';
             }
             else {
-                throw new ParseError(spaceTrim(`
+                throw new ParseError(spaceTrim$2(`
                         FOREACH ${formatName} ${subformatName} must specify output subparameter
 
                         Correct example:
@@ -19291,7 +20304,7 @@ const formatCommandParser = {
     /**
      * Description of the FORMAT command
      */
-    description: spaceTrim(`
+    description: spaceTrim$2(`
         Format command describes the desired output of the task (after post-processing)
         It can set limits for the maximum/minimum length of the output, measured in characters, words, sentences, paragraphs or some other shape of the output.
     `),
@@ -19663,7 +20676,7 @@ const formfactorCommandParser = {
         const formfactorNameCandidate = args[0].toUpperCase();
         const formfactor = FORMFACTOR_DEFINITIONS.find((definition) => [definition.name, ...{ aliasNames: [], ...definition }.aliasNames].includes(formfactorNameCandidate));
         if (formfactor === undefined) {
-            throw new ParseError(spaceTrim((block) => `
+            throw new ParseError(spaceTrim$2((block) => `
                         Unknown formfactor name "${formfactorNameCandidate}"
 
                         Available formfactors:
@@ -19682,7 +20695,7 @@ const formfactorCommandParser = {
      */
     $applyToPipelineJson(command, $pipelineJson) {
         if ($pipelineJson.formfactorName !== undefined && $pipelineJson.formfactorName !== command.formfactorName) {
-            throw new ParseError(spaceTrim(`
+            throw new ParseError(spaceTrim$2(`
                     Redefinition of \`FORMFACTOR\` in the pipeline head
 
                     You have used:
@@ -19825,7 +20838,7 @@ const modelCommandParser = {
      */
     parse(input) {
         const { args, normalized } = input;
-        const availableVariantsMessage = spaceTrim((block) => `
+        const availableVariantsMessage = spaceTrim$2((block) => `
               Available variants are:
               ${block(MODEL_VARIANTS.map((variantName) => `- ${variantName}${variantName !== 'EMBEDDING' ? '' : ' (Not available in pipeline)'}`).join('\n'))}
           `);
@@ -19847,14 +20860,14 @@ const modelCommandParser = {
                 // <- Note: [🤖]
             }
             else if (normalized.startsWith('MODEL_VARIANT_EMBED')) {
-                spaceTrim((block) => `
+                spaceTrim$2((block) => `
                         Embedding model can not be used in pipeline
 
                         ${block(availableVariantsMessage)}
                     `);
             }
             else {
-                throw new ParseError(spaceTrim((block) => `
+                throw new ParseError(spaceTrim$2((block) => `
                             Unknown model variant in command:
 
                             ${block(availableVariantsMessage)}
@@ -19869,7 +20882,7 @@ const modelCommandParser = {
             };
         }
         else {
-            throw new ParseError(spaceTrim((block) => `
+            throw new ParseError(spaceTrim$2((block) => `
                     Unknown model key in command.
 
                     Supported model keys are:
@@ -19896,7 +20909,7 @@ const modelCommandParser = {
                 // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             }
             else {
-                throw new ParseError(spaceTrim(`
+                throw new ParseError(spaceTrim$2(`
                         Redefinition of \`MODEL ${command.key}\` in the pipeline head
 
                         You have used:
@@ -19928,7 +20941,7 @@ const modelCommandParser = {
                 // <- TODO: [🏮] Some standard way how to transform errors into warnings and how to handle non-critical fails during the tasks
             }
             else {
-                throw new ParseError(spaceTrim(`
+                throw new ParseError(spaceTrim$2(`
                               Redefinition of MODEL \`${command.key}\` in the task "${$taskJson.title || $taskJson.name}"
 
                               You have used:
@@ -19938,7 +20951,7 @@ const modelCommandParser = {
             }
         }
         if (command.value === ($pipelineJson.defaultModelRequirements || {})[command.key]) {
-            console.log(spaceTrim(`
+            console.log(spaceTrim$2(`
                     Setting MODEL \`${command.key}\` in the task "${$taskJson.title || $taskJson.name}" to the same value as in the pipeline head
 
                     In pipeline head:
@@ -20021,7 +21034,7 @@ const parameterCommandParser = {
         // <- TODO: When [🥶] fixed, change to:
         //        >   const parameterDescriptionRaw = rawArgs.split(parameterNameRaw).join('').trim();
         if (parameterDescriptionRaw && parameterDescriptionRaw.match(/\{(?<embeddedParameterName>[a-z0-9_]+)\}/im)) {
-            throw new ParseError(spaceTrim((block) => `
+            throw new ParseError(spaceTrim$2((block) => `
                         Parameter \`{${parameterNameRaw}}\` can not contain another parameter in description
 
                         The description:
@@ -20203,7 +21216,7 @@ function $applyToTaskJson(command, $taskJson, $pipelineJson) {
         persona.description = personaDescription;
         return;
     }
-    console.warn(spaceTrim(`
+    console.warn(spaceTrim$2(`
 
             Persona "${personaName}" is defined multiple times with different description:
 
@@ -20214,7 +21227,7 @@ function $applyToTaskJson(command, $taskJson, $pipelineJson) {
             ${personaDescription}
 
         `));
-    persona.description += spaceTrim('\n\n' + personaDescription);
+    persona.description += spaceTrim$2('\n\n' + personaDescription);
 }
 
 /**
@@ -21055,7 +22068,7 @@ function removeMarkdownComments(content) {
  */
 function isFlatPipeline(pipelineString) {
     pipelineString = removeMarkdownComments(pipelineString);
-    pipelineString = spaceTrim(pipelineString);
+    pipelineString = spaceTrim$2(pipelineString);
     const isMarkdownBeginningWithHeadline = pipelineString.startsWith('# ');
     //const isLastLineReturnStatement = pipelineString.split('\n').pop()!.split('`').join('').startsWith('->');
     const isBacktickBlockUsed = pipelineString.includes('```');
@@ -21081,7 +22094,7 @@ function deflatePipeline(pipelineString) {
     if (!isFlatPipeline(pipelineString)) {
         return pipelineString;
     }
-    pipelineString = spaceTrim(pipelineString);
+    pipelineString = spaceTrim$2(pipelineString);
     const pipelineStringLines = pipelineString.split('\n');
     const potentialReturnStatement = pipelineStringLines.pop();
     let returnStatement;
@@ -21094,19 +22107,19 @@ function deflatePipeline(pipelineString) {
         returnStatement = `-> {${DEFAULT_BOOK_OUTPUT_PARAMETER_NAME}}`;
         pipelineStringLines.push(potentialReturnStatement);
     }
-    const prompt = spaceTrim(pipelineStringLines.join('\n'));
+    const prompt = spaceTrim$2(pipelineStringLines.join('\n'));
     let quotedPrompt;
     if (prompt.split('\n').length <= 1) {
         quotedPrompt = `> ${prompt}`;
     }
     else {
-        quotedPrompt = spaceTrim((block) => `
+        quotedPrompt = spaceTrim$2((block) => `
                 \`\`\`
                 ${block(prompt.split('`').join('\\`'))}
                 \`\`\`
             `);
     }
-    pipelineString = validatePipelineString(spaceTrim((block) => `
+    pipelineString = validatePipelineString(spaceTrim$2((block) => `
                 # ${DEFAULT_BOOK_TITLE}
 
                 ## Prompt
@@ -21164,7 +22177,7 @@ function parseMarkdownSection(value) {
     }
     const title = lines[0].replace(/^#+\s*/, '');
     const level = (_b = (_a = lines[0].match(/^#+/)) === null || _a === void 0 ? void 0 : _a[0].length) !== null && _b !== void 0 ? _b : 0;
-    const content = spaceTrim(lines.slice(1).join('\n'));
+    const content = spaceTrim$2(lines.slice(1).join('\n'));
     if (level < 1 || level > 6) {
         throw new ParseError('Markdown section must have heading level between 1 and 6');
     }
@@ -21192,7 +22205,7 @@ function splitMarkdownIntoSections(markdown) {
         if (buffer.length === 0) {
             return;
         }
-        let section = spaceTrim(buffer.join('\n'));
+        let section = spaceTrim$2(buffer.join('\n'));
         if (section === '') {
             return;
         }
@@ -21267,7 +22280,7 @@ function flattenMarkdown(markdown) {
         flattenedMarkdown += `## ${title}` + `\n\n`;
         flattenedMarkdown += content + `\n\n`; // <- [🧠] Maybe 3 new lines?
     }
-    return spaceTrim(flattenedMarkdown);
+    return spaceTrim$2(flattenedMarkdown);
 }
 /**
  * TODO: [🏛] This can be part of markdown builder
@@ -21968,7 +22981,7 @@ async function createPipelineCollectionFromDirectory(rootPath, tools, options) {
             catch (error) {
                 assertsError(error);
                 // TODO: [7] DRY
-                const wrappedErrorMessage = spaceTrim((block) => `
+                const wrappedErrorMessage = spaceTrim$2((block) => `
                             ${error.name} in pipeline ${fileName.split('\\').join('/')}⁠:
 
                             Original error message:
@@ -22003,7 +23016,7 @@ async function createPipelineCollectionFromDirectory(rootPath, tools, options) {
                         pipeline = { ...pipeline, pipelineUrl };
                     }
                     else if (!pipeline.pipelineUrl.startsWith(rootUrl)) {
-                        throw new PipelineUrlError(spaceTrim(`
+                        throw new PipelineUrlError(spaceTrim$2(`
                                 Pipeline with URL ${pipeline.pipelineUrl} is not a child of the root URL ${rootUrl} 🍏
 
                                 File:
@@ -22041,7 +23054,7 @@ async function createPipelineCollectionFromDirectory(rootPath, tools, options) {
                     }
                     else {
                         const existing = collection.get(pipeline.pipelineUrl);
-                        throw new PipelineUrlError(spaceTrim(`
+                        throw new PipelineUrlError(spaceTrim$2(`
                                 Pipeline with URL ${pipeline.pipelineUrl} is already in the collection 🍏
 
                                 Conflicting files:
@@ -22059,7 +23072,7 @@ async function createPipelineCollectionFromDirectory(rootPath, tools, options) {
             catch (error) {
                 assertsError(error);
                 // TODO: [7] DRY
-                const wrappedErrorMessage = spaceTrim((block) => `
+                const wrappedErrorMessage = spaceTrim$2((block) => `
                             ${error.name} in pipeline ${fileName.split('\\').join('/')}⁠:
 
                             Original error message:
@@ -22235,7 +23248,7 @@ async function $getCompiledBook(tools, pipelineSource, options) {
         // console.log(`Strategy 3️⃣`);
         const response = await fetch(pipelineSource);
         if (response.status >= 300) {
-            throw new NotFoundError(spaceTrim((block) => `
+            throw new NotFoundError(spaceTrim$2((block) => `
                         Book not found on URL:
                         ${block(pipelineSource)}
 
@@ -22245,7 +23258,7 @@ async function $getCompiledBook(tools, pipelineSource, options) {
         const pipelineString = await response.text();
         // console.log({ pipelineString });
         if (!isValidPipelineString(pipelineString)) {
-            throw new NotFoundError(spaceTrim((block) => `
+            throw new NotFoundError(spaceTrim$2((block) => `
                         Book not found on URL:
                         ${block(pipelineSource)}
 
@@ -22267,7 +23280,7 @@ async function $getCompiledBook(tools, pipelineSource, options) {
         });
         return pipelineJson;
     } /* not else */
-    throw new NotFoundError(spaceTrim((block) => `
+    throw new NotFoundError(spaceTrim$2((block) => `
                 Book not found:
                 ${block(pipelineSource)}