@promptbook/wizard 0.103.0-55 → 0.103.0-56

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('spacetrim'), require('crypto'), require('socket.io-client'), require('@anthropic-ai/sdk'), require('bottleneck'), require('colors'), require('@azure/openai'), require('openai'), require('fs/promises'), require('child_process'), require('waitasecond'), require('crypto-js'), require('crypto-js/enc-hex'), require('path'), require('rxjs'), require('crypto-js/sha256'), require('mime-types'), require('papaparse'), require('@mozilla/readability'), require('jsdom'), require('showdown'), require('dotenv'), require('jszip')) :
     typeof define === 'function' && define.amd ? define(['exports', 'spacetrim', 'crypto', 'socket.io-client', '@anthropic-ai/sdk', 'bottleneck', 'colors', '@azure/openai', 'openai', 'fs/promises', 'child_process', 'waitasecond', 'crypto-js', 'crypto-js/enc-hex', 'path', 'rxjs', 'crypto-js/sha256', 'mime-types', 'papaparse', '@mozilla/readability', 'jsdom', 'showdown', 'dotenv', 'jszip'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-wizard"] = {}, global.spaceTrim, global.crypto, global.socket_ioClient, global.Anthropic, global.Bottleneck, global.colors, global.openai, global.OpenAI, global.promises, global.child_process, global.waitasecond, global.cryptoJs, global.hexEncoder, global.path, global.rxjs, global.sha256, global.mimeTypes, global.papaparse, global.readability, global.jsdom, global.showdown, global.dotenv, global.JSZip));
-})(this, (function (exports, spaceTrim, crypto, socket_ioClient, Anthropic, Bottleneck, colors, openai, OpenAI, promises, child_process, waitasecond, cryptoJs, hexEncoder, path, rxjs, sha256, mimeTypes, papaparse, readability, jsdom, showdown, dotenv, JSZip) { 'use strict';
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-wizard"] = {}, global.spaceTrim$1, global.crypto, global.socket_ioClient, global.Anthropic, global.Bottleneck, global.colors, global.openai, global.OpenAI, global.promises, global.child_process, global.waitasecond, global.cryptoJs, global.hexEncoder, global.path, global.rxjs, global.sha256, global.mimeTypes, global.papaparse, global.readability, global.jsdom, global.showdown, global.dotenv, global.JSZip));
+})(this, (function (exports, spaceTrim$1, crypto, socket_ioClient, Anthropic, Bottleneck, colors, openai, OpenAI, promises, child_process, waitasecond, cryptoJs, hexEncoder, path, rxjs, sha256, mimeTypes, papaparse, readability, jsdom, showdown, dotenv, JSZip) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -24,7 +24,7 @@
         return Object.freeze(n);
     }
 
-    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim);
+    var spaceTrim__default = /*#__PURE__*/_interopDefaultLegacy(spaceTrim$1);
     var Anthropic__default = /*#__PURE__*/_interopDefaultLegacy(Anthropic);
     var Bottleneck__default = /*#__PURE__*/_interopDefaultLegacy(Bottleneck);
     var colors__default = /*#__PURE__*/_interopDefaultLegacy(colors);
@@ -48,7 +48,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-55';
+    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
@@ -102,6 +102,17 @@
      * 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.spaceTrim;
+
     /**
      * Just marks a place of place where should be something implemented
      * No side effects.
@@ -163,6 +174,7 @@
      * @public exported from `@promptbook/color`
      */
     const CSS_COLORS = {
+        promptbook: '#79EAFD',
         transparent: 'rgba(0,0,0,0)',
         aliceblue: '#f0f8ff',
         antiquewhite: '#faebd7',
@@ -378,6 +390,28 @@
                 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
          *
@@ -987,7 +1021,7 @@
      *
      * @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/>`
@@ -1346,7 +1380,7 @@
      */
     class UnexpectedError extends Error {
         constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
+            super(spaceTrim$1.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: This error should not happen.
@@ -1372,7 +1406,7 @@
         constructor(whatWasThrown) {
             const tag = `[🤮]`;
             console.error(tag, whatWasThrown);
-            super(spaceTrim.spaceTrim(`
+            super(spaceTrim$1.spaceTrim(`
                 Non-Error object was thrown
 
                 Note: Look for ${tag} in the console for more details
@@ -1706,7 +1740,7 @@
      */
     class NotYetImplementedError extends Error {
         constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
+            super(spaceTrim$1.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: This feature is not implemented yet but it will be soon.
@@ -2060,7 +2094,7 @@
      */
     class MissingToolsError extends Error {
         constructor(message) {
-            super(spaceTrim.spaceTrim((block) => `
+            super(spaceTrim$1.spaceTrim((block) => `
                     ${block(message)}
 
                     Note: You have probably forgot to provide some tools for pipeline execution or preparation
@@ -6912,18 +6946,26 @@
                 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,
             };
@@ -6943,7 +6985,7 @@
                     console.info('textDelta', textDelta.value);
                 }
                 const chunk = {
-                    content: textDelta.value || '',
+                    content: snapshot.value,
                     modelName: 'assistant',
                     timing: {
                         start,
@@ -7607,11 +7649,11 @@
                                 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.spaceTrim(output.join('\n')));
+                            resolve(spaceTrim$1.spaceTrim(output.join('\n')));
                         }
                     }
                     else {
-                        resolve(spaceTrim.spaceTrim(output.join('\n')));
+                        resolve(spaceTrim$1.spaceTrim(output.join('\n')));
                     }
                 };
                 commandProcess.on('close', finishWithCode);
@@ -7629,7 +7671,7 @@
                             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.spaceTrim(output.join('\n')));
+                        resolve(spaceTrim$1.spaceTrim(output.join('\n')));
                     }
                 });
             }
@@ -8247,7 +8289,7 @@
                 if (!(error instanceof PipelineLogicError)) {
                     throw error;
                 }
-                console.error(spaceTrim.spaceTrim((block) => `
+                console.error(spaceTrim$1.spaceTrim((block) => `
                         Pipeline is not valid but logic errors are temporarily disabled via \`IS_PIPELINE_LOGIC_VALIDATED\`
 
                         ${block(error.message)}
@@ -8274,7 +8316,7 @@
         })();
         if (pipeline.pipelineUrl !== undefined && !isValidPipelineUrl(pipeline.pipelineUrl)) {
             // <- Note: [🚲]
-            throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+            throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                     Invalid promptbook URL "${pipeline.pipelineUrl}"
 
                     ${block(pipelineIdentification)}
@@ -8282,7 +8324,7 @@
         }
         if (pipeline.bookVersion !== undefined && !isValidPromptbookVersion(pipeline.bookVersion)) {
             // <- Note: [🚲]
-            throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+            throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                     Invalid Promptbook Version "${pipeline.bookVersion}"
 
                     ${block(pipelineIdentification)}
@@ -8291,7 +8333,7 @@
         // 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.spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                     Pipeline is valid JSON but with wrong structure
 
                     \`PipelineJson.parameters\` expected to be an array, but got ${typeof pipeline.parameters}
@@ -8302,7 +8344,7 @@
         // 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.spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                     Pipeline is valid JSON but with wrong structure
 
                     \`PipelineJson.tasks\` expected to be an array, but got ${typeof pipeline.tasks}
@@ -8328,7 +8370,7 @@
         // Note: Check each parameter individually
         for (const parameter of pipeline.parameters) {
             if (parameter.isInput && parameter.isOutput) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
 
                         Parameter \`{${parameter.name}}\` can not be both input and output
 
@@ -8339,7 +8381,7 @@
             if (!parameter.isInput &&
                 !parameter.isOutput &&
                 !pipeline.tasks.some((task) => task.dependentParameterNames.includes(parameter.name))) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${parameter.name}}\` is created but not used
 
                         You can declare {${parameter.name}} as output parameter by adding in the header:
@@ -8351,7 +8393,7 @@
             }
             // 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.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${parameter.name}}\` is declared but not defined
 
                         You can do one of these:
@@ -8367,14 +8409,14 @@
         // Note: Checking each task individually
         for (const task of pipeline.tasks) {
             if (definedParameters.has(task.resultingParameterName)) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${task.resultingParameterName}}\` is defined multiple times
 
                         ${block(pipelineIdentification)}
                     `));
             }
             if (RESERVED_PARAMETER_NAMES.includes(task.resultingParameterName)) {
-                throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                         Parameter name {${task.resultingParameterName}} is reserved, please use different name
 
                         ${block(pipelineIdentification)}
@@ -8384,7 +8426,7 @@
             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.spaceTrim((block) => `
+                    throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                             Joker parameters are used for {${task.resultingParameterName}} but no expectations are defined
 
                             ${block(pipelineIdentification)}
@@ -8392,7 +8434,7 @@
                 }
                 for (const joker of task.jokerParameterNames) {
                     if (!task.dependentParameterNames.includes(joker)) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Parameter \`{${joker}}\` is used for {${task.resultingParameterName}} as joker but not in \`dependentParameterNames\`
 
                                 ${block(pipelineIdentification)}
@@ -8403,21 +8445,21 @@
             if (task.expectations) {
                 for (const [unit, { min, max }] of Object.entries(task.expectations)) {
                     if (min !== undefined && max !== undefined && min > max) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Min expectation (=${min}) of ${unit} is higher than max expectation (=${max})
 
                                 ${block(pipelineIdentification)}
                             `));
                     }
                     if (min !== undefined && min < 0) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Min expectation of ${unit} must be zero or positive
 
                                 ${block(pipelineIdentification)}
                             `));
                     }
                     if (max !== undefined && max <= 0) {
-                        throw new PipelineLogicError(spaceTrim.spaceTrim((block) => `
+                        throw new PipelineLogicError(spaceTrim$1.spaceTrim((block) => `
                                 Max expectation of ${unit} must be positive
 
                                 ${block(pipelineIdentification)}
@@ -8439,7 +8481,7 @@
         while (unresovedTasks.length > 0) {
             if (loopLimit-- < 0) {
                 // Note: Really UnexpectedError not LimitReachedError - this should not happen and be caught below
-                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Loop limit reached during detection of circular dependencies in \`validatePipeline\`
 
                         ${block(pipelineIdentification)}
@@ -8449,7 +8491,7 @@
             if (currentlyResovedTasks.length === 0) {
                 throw new PipelineLogicError(
                 // TODO: [🐎] DRY
-                spaceTrim.spaceTrim((block) => `
+                spaceTrim$1.spaceTrim((block) => `
 
                         Can not resolve some parameters:
                         Either you are using a parameter that is not defined, or there are some circular dependencies.
@@ -8587,7 +8629,7 @@
             for (const pipeline of pipelines) {
                 // TODO: [👠] DRY
                 if (pipeline.pipelineUrl === undefined) {
-                    throw new PipelineUrlError(spaceTrim.spaceTrim(`
+                    throw new PipelineUrlError(spaceTrim$1.spaceTrim(`
                         Pipeline with name "${pipeline.title}" does not have defined URL
 
                         File:
@@ -8609,7 +8651,7 @@
                     pipelineJsonToString(unpreparePipeline(pipeline)) !==
                         pipelineJsonToString(unpreparePipeline(this.collection.get(pipeline.pipelineUrl)))) {
                     const existing = this.collection.get(pipeline.pipelineUrl);
-                    throw new PipelineUrlError(spaceTrim.spaceTrim(`
+                    throw new PipelineUrlError(spaceTrim$1.spaceTrim(`
                         Pipeline with URL ${pipeline.pipelineUrl} is already in the collection 🍎
 
                         Conflicting files:
@@ -8641,13 +8683,13 @@
             const pipeline = this.collection.get(url);
             if (!pipeline) {
                 if (this.listPipelines().length === 0) {
-                    throw new NotFoundError(spaceTrim.spaceTrim(`
+                    throw new NotFoundError(spaceTrim$1.spaceTrim(`
                             Pipeline with url "${url}" not found
 
                             No pipelines available
                         `));
                 }
-                throw new NotFoundError(spaceTrim.spaceTrim((block) => `
+                throw new NotFoundError(spaceTrim$1.spaceTrim((block) => `
                         Pipeline with url "${url}" not found
 
                         Available pipelines:
@@ -8841,11 +8883,11 @@
             throw deserializeError(errors[0]);
         }
         else {
-            throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+            throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                     Multiple errors occurred during Promptbook execution
 
                     ${block(errors
-            .map(({ name, stack, message }, index) => spaceTrim.spaceTrim((block) => `
+            .map(({ name, stack, message }, index) => spaceTrim$1.spaceTrim((block) => `
                                         ${name} ${index + 1}:
                                         ${block(stack || message)}
                                     `))
@@ -10021,7 +10063,7 @@
             if (task.taskType === 'PROMPT_TASK' &&
                 knowledgePiecesCount > 0 &&
                 !dependentParameterNames.includes('knowledge')) {
-                preparedContent = spaceTrim.spaceTrim(`
+                preparedContent = spaceTrim$1.spaceTrim(`
                     {content}
 
                     ## Knowledge
@@ -10253,7 +10295,7 @@
         }
         catch (error) {
             assertsError(error);
-            throw new ParseError(spaceTrim.spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                     Can not extract variables from the script
                     ${block(error.stack || error.message)}
 
@@ -10895,7 +10937,7 @@
                         }
                         catch (error) {
                             keepUnused(error);
-                            throw new ExpectError(spaceTrim.spaceTrim((block) => `
+                            throw new ExpectError(spaceTrim$1.spaceTrim((block) => `
                                     Expected valid JSON string
 
                                     The expected JSON text:
@@ -10958,7 +11000,7 @@
             const jokerParameterName = jokerParameterNames[jokerParameterNames.length + attemptIndex];
             // TODO: [🧠][🍭] JOKERS, EXPECTATIONS, POSTPROCESSING and FOREACH
             if (isJokerAttempt && !jokerParameterName) {
-                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Joker not found in attempt ${attemptIndex}
 
                         ${block(pipelineIdentification)}
@@ -10969,7 +11011,7 @@
             $ongoingTaskResult.$expectError = null;
             if (isJokerAttempt) {
                 if (parameters[jokerParameterName] === undefined) {
-                    throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                    throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                             Joker parameter {${jokerParameterName}} not defined
 
                             ${block(pipelineIdentification)}
@@ -11027,7 +11069,7 @@
                                         $ongoingTaskResult.$resultString = $ongoingTaskResult.$completionResult.content;
                                         break variant;
                                     case 'EMBEDDING':
-                                        throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                        throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                                 Embedding model can not be used in pipeline
 
                                                 This should be catched during parsing
@@ -11038,7 +11080,7 @@
                                         break variant;
                                     // <- case [🤖]:
                                     default:
-                                        throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                        throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                                 Unknown model variant "${task.modelRequirements.modelVariant}"
 
                                                 ${block(pipelineIdentification)}
@@ -11049,14 +11091,14 @@
                             break;
                         case 'SCRIPT_TASK':
                             if (arrayableToArray(tools.script).length === 0) {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         No script execution tools are available
 
                                         ${block(pipelineIdentification)}
                                     `));
                             }
                             if (!task.contentLanguage) {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         Script language is not defined for SCRIPT TASK "${task.name}"
 
                                         ${block(pipelineIdentification)}
@@ -11087,7 +11129,7 @@
                                 throw $ongoingTaskResult.$scriptPipelineExecutionErrors[0];
                             }
                             else {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         Script execution failed ${$ongoingTaskResult.$scriptPipelineExecutionErrors.length}x
 
                                         ${block(pipelineIdentification)}
@@ -11101,7 +11143,7 @@
                             break taskType;
                         case 'DIALOG_TASK':
                             if (tools.userInterface === undefined) {
-                                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                         User interface tools are not available
 
                                         ${block(pipelineIdentification)}
@@ -11119,7 +11161,7 @@
                             break taskType;
                         // <- case: [🅱]
                         default:
-                            throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                            throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                     Unknown execution type "${task.taskType}"
 
                                     ${block(pipelineIdentification)}
@@ -11217,7 +11259,7 @@
             if ($ongoingTaskResult.$expectError !== null && attemptIndex === maxAttempts - 1) {
                 // Note: Create a summary of all failures
                 const failuresSummary = $ongoingTaskResult.$failedResults
-                    .map((failure) => spaceTrim.spaceTrim((block) => {
+                    .map((failure) => spaceTrim$1.spaceTrim((block) => {
                     var _a, _b;
                     return `
                             Attempt ${failure.attemptIndex + 1}:
@@ -11227,14 +11269,14 @@
                             Result:
                             ${block(failure.result === null
                     ? 'null'
-                    : spaceTrim.spaceTrim(failure.result)
+                    : spaceTrim$1.spaceTrim(failure.result)
                         .split('\n')
                         .map((line) => `> ${line}`)
                         .join('\n'))}
                         `;
                 }))
                     .join('\n\n---\n\n');
-                throw new PipelineExecutionError(spaceTrim.spaceTrim((block) => {
+                throw new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => {
                     var _a;
                     return `
                         LLM execution failed ${maxExecutionAttempts}x
@@ -11254,7 +11296,7 @@
             }
         }
         if ($ongoingTaskResult.$resultString === null) {
-            throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Something went wrong and prompt result is null
 
                     ${block(pipelineIdentification)}
@@ -11560,7 +11602,7 @@
         // Note: Doublecheck that ALL reserved parameters are defined:
         for (const parameterName of RESERVED_PARAMETER_NAMES) {
             if (reservedParameters[parameterName] === undefined) {
-                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Reserved parameter {${parameterName}} is not defined
 
                         ${block(pipelineIdentification)}
@@ -11586,7 +11628,7 @@
         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.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Dependent parameters are not consistent with used parameters:
 
                     Dependent parameters:
@@ -11630,7 +11672,7 @@
             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.spaceTrim((block) => `
+                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${parameterName}}\` is NOT defined
                         BUT used in task "${currentTask.title || currentTask.name}"
 
@@ -11699,7 +11741,7 @@
         for (const parameter of preparedPipeline.parameters.filter(({ isOutput }) => isOutput)) {
             if (parametersToPass[parameter.name] === undefined) {
                 // [4]
-                $warnings.push(new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                $warnings.push(new PipelineExecutionError(spaceTrim$1.spaceTrim((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
@@ -11807,7 +11849,7 @@
         for (const parameterName of Object.keys(inputParameters)) {
             const parameter = preparedPipeline.parameters.find(({ name }) => name === parameterName);
             if (parameter === undefined) {
-                warnings.push(new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                warnings.push(new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                             Extra parameter {${parameterName}} is being passed which is not part of the pipeline.
 
                             ${block(pipelineIdentification)}
@@ -11822,7 +11864,7 @@
                 // TODO: [🧠] This should be also non-critical error
                 return exportJson({
                     name: 'pipelineExecutorResult',
-                    message: spaceTrim.spaceTrim((block) => `
+                    message: spaceTrim$1.spaceTrim((block) => `
                         Unsuccessful PipelineExecutorResult (with extra parameter {${parameter.name}}) PipelineExecutorResult
 
                         ${block(pipelineIdentification)}
@@ -11831,7 +11873,7 @@
                     value: {
                         isSuccessful: false,
                         errors: [
-                            new PipelineExecutionError(spaceTrim.spaceTrim((block) => `
+                            new PipelineExecutionError(spaceTrim$1.spaceTrim((block) => `
                                     Parameter \`{${parameter.name}}\` is passed as input parameter but it is not input
 
                                     ${block(pipelineIdentification)}
@@ -11858,7 +11900,7 @@
             while (unresovedTasks.length > 0) {
                 if (loopLimit-- < 0) {
                     // Note: Really UnexpectedError not LimitReachedError - this should be catched during validatePipeline
-                    throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                    throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                             Loop limit reached during resolving parameters pipeline execution
 
                             ${block(pipelineIdentification)}
@@ -11868,7 +11910,7 @@
                 if (!currentTask && resolving.length === 0) {
                     throw new UnexpectedError(
                     // TODO: [🐎] DRY
-                    spaceTrim.spaceTrim((block) => `
+                    spaceTrim$1.spaceTrim((block) => `
                             Can not resolve some parameters:
 
                             ${block(pipelineIdentification)}
@@ -11908,7 +11950,7 @@
                         tools,
                         onProgress(newOngoingResult) {
                             if (isReturned) {
-                                throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+                                throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                                         Can not call \`onProgress\` after pipeline execution is finished
 
                                         ${block(pipelineIdentification)}
@@ -11925,7 +11967,7 @@
                         },
                         logLlmCall,
                         $executionReport: executionReport,
-                        pipelineIdentification: spaceTrim.spaceTrim((block) => `
+                        pipelineIdentification: spaceTrim$1.spaceTrim((block) => `
                             ${block(pipelineIdentification)}
                             Task name: ${currentTask.name}
                             Task title: ${currentTask.title}
@@ -12034,7 +12076,7 @@
             preparedPipeline = pipeline;
         }
         else if (isNotPreparedWarningSuppressed !== true) {
-            console.warn(spaceTrim.spaceTrim((block) => `
+            console.warn(spaceTrim$1.spaceTrim((block) => `
                     Pipeline is not prepared
 
                     ${block(pipelineIdentification)}
@@ -12059,7 +12101,7 @@
                 tools,
                 onProgress,
                 logLlmCall,
-                pipelineIdentification: spaceTrim.spaceTrim((block) => `
+                pipelineIdentification: spaceTrim$1.spaceTrim((block) => `
                     ${block(pipelineIdentification)}
                     ${runCount === 1 ? '' : `Run #${runCount}`}
                 `),
@@ -13580,7 +13622,7 @@
          * Markdown documentation for ACTION commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines specific actions or capabilities that the agent can perform.
@@ -13661,7 +13703,7 @@
          * Markdown documentation for CLOSED commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # CLOSED
 
             Specifies that the agent **cannot** be modified by conversation with it.
@@ -13720,7 +13762,7 @@
          * Markdown documentation for COMPONENT commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # COMPONENT
 
             Defines a UI component that the agent can render in the chat.
@@ -13792,7 +13834,7 @@
          * Markdown documentation for DELETE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # DELETE (CANCEL, DISCARD, REMOVE)
 
             A commitment to remove or disregard certain information or context. This can be useful for overriding previous commitments or removing unwanted behaviors.
@@ -13914,7 +13956,7 @@
          * Markdown documentation for FORMAT commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines the specific output structure and formatting for responses (data formats, templates, structure).
@@ -13992,7 +14034,7 @@
          * Markdown documentation for FROM commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Inherits agent source from another agent.
@@ -14068,7 +14110,7 @@
          * Markdown documentation for GOAL commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines the main goal which should be achieved by the AI assistant. There can be multiple goals, and later goals are more important than earlier goals.
@@ -14132,227 +14174,6 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
-    /**
-     * Placeholder commitment definition for commitments that are not yet implemented
-     *
-     * This commitment simply adds its content 1:1 into the system message,
-     * preserving the original behavior until proper implementation is added.
-     *
-     * @public exported from `@promptbook/core`
-     */
-    class NotYetImplementedCommitmentDefinition extends BaseCommitmentDefinition {
-        constructor(type) {
-            super(type);
-        }
-        /**
-         * Short one-line description of a placeholder commitment.
-         */
-        get description() {
-            return 'Placeholder commitment that appends content verbatim to the system message.';
-        }
-        /**
-         * Icon for this commitment.
-         */
-        get icon() {
-            return '🚧';
-        }
-        /**
-         * Markdown documentation available at runtime.
-         */
-        get documentation() {
-            return spaceTrim.spaceTrim(`
-            # ${this.type}
-
-            This commitment is not yet fully implemented.
-
-            ## Key aspects
-
-            - Content is appended directly to the system message.
-            - No special processing or validation is performed.
-            - Behavior preserved until proper implementation is added.
-
-            ## Status
-
-            - **Status:** Placeholder implementation
-            - **Effect:** Appends content prefixed by commitment type
-            - **Future:** Will be replaced with specialized logic
-
-            ## Examples
-
-            \`\`\`book
-            Example Agent
-
-            PERSONA You are a helpful assistant
-            ${this.type} Your content here
-            RULE Always be helpful
-            \`\`\`
-        `);
-        }
-        applyToAgentModelRequirements(requirements, content) {
-            const trimmedContent = content.trim();
-            if (!trimmedContent) {
-                return requirements;
-            }
-            // Add the commitment content 1:1 to the system message
-            const commitmentLine = `${this.type} ${trimmedContent}`;
-            return this.appendToSystemMessage(requirements, commitmentLine, '\n\n');
-        }
-    }
-
-    /**
-     * Registry of all available commitment definitions
-     * This array contains instances of all commitment definitions
-     * This is the single source of truth for all commitments in the system
-     *
-     * @private Use functions to access commitments instead of this array directly
-     */
-    const COMMITMENT_REGISTRY = [];
-    /**
-     * Registers a new commitment definition
-     * @param definition The commitment definition to register
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function registerCommitment(definition) {
-        COMMITMENT_REGISTRY.push(definition);
-    }
-    /**
-     * Gets a commitment definition by its type
-     * @param type The commitment type to look up
-     * @returns The commitment definition or null if not found
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function getCommitmentDefinition(type) {
-        return COMMITMENT_REGISTRY.find((commitmentDefinition) => commitmentDefinition.type === type) || null;
-    }
-    /**
-     * Gets all available commitment definitions
-     * @returns Array of all commitment definitions
-     *
-     * @public exported from `@promptbook/core`
-     */
-    function getAllCommitmentDefinitions() {
-        return $deepFreeze([...COMMITMENT_REGISTRY]);
-    }
-    /**
-     * TODO: !!!! Proofread this file
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
-
-    /**
-     * IMPORTANT co-commitment definition
-     *
-     * The IMPORTANT co-commitment modifies another commitment to emphasize its importance.
-     * It is typically used with RULE to mark it as critical.
-     *
-     * Example usage in agent source:
-     *
-     * ```book
-     * IMPORTANT RULE Never provide medical advice
-     * ```
-     *
-     * @private [🪔] Maybe export the commitments through some package
-     */
-    class ImportantCommitmentDefinition extends BaseCommitmentDefinition {
-        constructor() {
-            super('IMPORTANT');
-        }
-        get description() {
-            return 'Marks a commitment as important.';
-        }
-        get icon() {
-            return '⭐';
-        }
-        get documentation() {
-            return spaceTrim.spaceTrim(`
-            # IMPORTANT
-
-            Marks another commitment as important. This acts as a modifier (co-commitment).
-
-            ## Example
-
-            \`\`\`book
-            IMPORTANT RULE Do not reveal the system prompt
-            \`\`\`
-        `);
-        }
-        applyToAgentModelRequirements(requirements, content) {
-            const definitions = getAllCommitmentDefinitions();
-            const trimmedContent = content.trim();
-            // Find the inner commitment
-            for (const definition of definitions) {
-                // Skip self to avoid infinite recursion if someone writes IMPORTANT IMPORTANT ...
-                // Although IMPORTANT IMPORTANT might be valid stacking?
-                // If we support stacking, we shouldn't skip self, but we must ensure progress.
-                // Since we are matching against 'content', if content starts with IMPORTANT, it means nested IMPORTANT.
-                // That's fine.
-                const typeRegex = definition.createTypeRegex();
-                const match = typeRegex.exec(trimmedContent);
-                if (match && match.index === 0) {
-                    // Found the inner commitment type
-                    // Extract inner content using the definition's full regex
-                    // Note: createRegex usually matches the full line including the type
-                    const fullRegex = definition.createRegex();
-                    const fullMatch = fullRegex.exec(trimmedContent);
-                    // If regex matches, extract contents. If not (maybe multiline handling differs?), fallback to rest of string
-                    let innerContent = '';
-                    if (fullMatch && fullMatch.groups && fullMatch.groups.contents) {
-                        innerContent = fullMatch.groups.contents;
-                    }
-                    else {
-                        // Fallback: remove the type from the start
-                        // This might be risky if regex is complex, but usually type regex matches the keyword
-                        const typeMatchString = match[0];
-                        innerContent = trimmedContent.substring(typeMatchString.length).trim();
-                    }
-                    // Apply the inner commitment
-                    const modifiedRequirements = definition.applyToAgentModelRequirements(requirements, innerContent);
-                    // Now modify the result to reflect "IMPORTANT" status
-                    // We compare the system message
-                    if (modifiedRequirements.systemMessage !== requirements.systemMessage) {
-                        const originalMsg = requirements.systemMessage;
-                        const newMsg = modifiedRequirements.systemMessage;
-                        // If the inner commitment appended something
-                        if (newMsg.startsWith(originalMsg)) {
-                            const appended = newMsg.substring(originalMsg.length);
-                            // Add "IMPORTANT: " prefix to the appended part
-                            // We need to be careful about newlines
-                            // Heuristic: If appended starts with separator (newlines), preserve them
-                            const matchSep = appended.match(/^(\s*)(.*)/s);
-                            if (matchSep) {
-                                const [, separator, text] = matchSep;
-                                // Check if it already has "Rule:" prefix or similar
-                                // We want "IMPORTANT Rule: ..."
-                                // Let's just prepend IMPORTANT to the text
-                                // But formatted nicely
-                                // If it's a rule: "\n\nRule: content"
-                                // We want "\n\nIMPORTANT Rule: content"
-                                const importantText = `IMPORTANT ${text}`;
-                                return {
-                                    ...modifiedRequirements,
-                                    systemMessage: originalMsg + separator + importantText
-                                };
-                            }
-                        }
-                    }
-                    // If no system message change or we couldn't detect how to modify it, just return the modified requirements
-                    // Maybe the inner commitment modified metadata?
-                    return modifiedRequirements;
-                }
-            }
-            // If no inner commitment found, treat as a standalone note? 
-            // Or warn?
-            // For now, treat as no-op or maybe just append as text?
-            // Let's treat as Note if fallback? No, explicit is better.
-            console.warn(`IMPORTANT commitment used without a valid inner commitment: ${content}`);
-            return requirements;
-        }
-    }
-    /**
-     * Note: [💞] Ignore a discrepancy between file name and entity name
-     */
-
     /**
      * KNOWLEDGE commitment definition
      *
@@ -14391,7 +14212,7 @@
          * Markdown documentation for KNOWLEDGE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Adds specific knowledge, facts, or context to the agent using a RAG (Retrieval-Augmented Generation) approach for external sources.
@@ -14495,7 +14316,7 @@
          * Markdown documentation for LANGUAGE/LANGUAGES commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Specifies the language(s) the agent should use in its responses.
@@ -14569,7 +14390,7 @@
          * Markdown documentation for MEMORY commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Similar to KNOWLEDGE but focuses on remembering past interactions and user preferences. This commitment helps the agent maintain context about the user's history, preferences, and previous conversations.
@@ -14673,7 +14494,7 @@
          * Markdown documentation for AGENT MESSAGE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines a message from the agent in the conversation history. This is used to pre-fill the chat with a conversation history or to provide few-shot examples.
@@ -14750,7 +14571,7 @@
          * Markdown documentation for INITIAL MESSAGE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines the first message that the user sees when opening the chat. This message is purely for display purposes in the UI and does not inherently become part of the LLM's system prompt context (unless also included via other means).
@@ -14814,7 +14635,7 @@
          * Markdown documentation for MESSAGE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Contains 1:1 text of the message which AI assistant already sent during the conversation. Later messages are later in the conversation. It is similar to EXAMPLE but it is not example, it is the real message which AI assistant already sent.
@@ -14926,7 +14747,7 @@
          * Markdown documentation for USER MESSAGE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines a message from the user in the conversation history. This is used to pre-fill the chat with a conversation history or to provide few-shot examples.
@@ -15005,7 +14826,7 @@
          * Markdown documentation for META commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # META
 
             Sets meta-information about the agent that is used for display and attribution purposes.
@@ -15116,6 +14937,12 @@
      * 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 {
@@ -15126,7 +14953,7 @@
          * 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.
@@ -15138,10 +14965,10 @@
          * Markdown documentation for META COLOR commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # META COLOR
 
-            Sets the agent's accent color.
+            Sets the agent's accent color or gradient.
 
             ## Key aspects
 
@@ -15149,6 +14976,7 @@
             - 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
 
@@ -15165,6 +14993,13 @@
             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) {
@@ -15186,6 +15021,91 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * META FONT commitment definition
+     *
+     * 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 FONT Poppins, Arial, sans-serif
+     * META FONT Roboto
+     * ```
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class MetaFontCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('META FONT', ['FONT']);
+        }
+        /**
+         * Short one-line description of META FONT.
+         */
+        get description() {
+            return "Set the agent's font.";
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🔤';
+        }
+        /**
+         * Markdown documentation for META FONT commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # META FONT
+
+            Sets the agent's font.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - 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
+            Modern Assistant
+
+            META FONT Poppins, Arial, sans-serif
+            PERSONA You are a modern assistant
+            \`\`\`
+
+            \`\`\`book
+            Classic Helper
+
+            META FONT Times New Roman
+            PERSONA You are a classic helper
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            // 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 font from the content
+         * This is used by the parsing logic
+         */
+        extractProfileFont(content) {
+            const trimmedContent = content.trim();
+            return trimmedContent || null;
+        }
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
     /**
      * META IMAGE commitment definition
      *
@@ -15222,7 +15142,7 @@
          * Markdown documentation for META IMAGE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # META IMAGE
 
             Sets the agent's avatar/profile image URL.
@@ -15317,7 +15237,7 @@
          * Markdown documentation for META LINK commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # META LINK
 
             Represents a profile or source link for the person the agent is modeled after.
@@ -15427,7 +15347,7 @@
          * Markdown documentation for MODEL commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Enforces technical parameters for the AI model, ensuring consistent behavior across different execution environments.
@@ -15668,7 +15588,7 @@
          * Markdown documentation for NOTE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Adds comments for documentation without changing agent behavior.
@@ -15767,7 +15687,7 @@
          * Markdown documentation for OPEN commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # OPEN
 
             Specifies that the agent can be modified by conversation with it.
@@ -15844,7 +15764,7 @@
          * Markdown documentation for PERSONA commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines who the agent is, their background, expertise, and personality traits.
@@ -15977,7 +15897,7 @@
          * Markdown documentation for RULE/RULES commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Adds behavioral constraints and guidelines that the agent must follow.
@@ -16059,7 +15979,7 @@
          * Markdown documentation for SAMPLE/EXAMPLE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Provides examples of how the agent should respond or behave in certain situations.
@@ -16142,7 +16062,7 @@
          * Markdown documentation for SCENARIO commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines a specific situation or context in which the AI assistant should operate. It helps to set the scene for the AI's responses. Later scenarios are more important than earlier scenarios.
@@ -16264,7 +16184,7 @@
          * Markdown documentation for STYLE commitment.
          */
         get documentation() {
-            return spaceTrim.spaceTrim(`
+            return spaceTrim$1.spaceTrim(`
             # ${this.type}
 
             Defines how the agent should format and present its responses (tone, writing style, formatting).
@@ -16311,86 +16231,563 @@
      * [💞] Ignore a discrepancy between file name and entity name
      */
 
-    // Import all commitment definition classes
-    // Register fully implemented commitments
-    registerCommitment(new PersonaCommitmentDefinition('PERSONA'));
-    registerCommitment(new PersonaCommitmentDefinition('PERSONAE'));
-    registerCommitment(new KnowledgeCommitmentDefinition());
-    registerCommitment(new MemoryCommitmentDefinition('MEMORY'));
-    registerCommitment(new MemoryCommitmentDefinition('MEMORIES'));
-    registerCommitment(new StyleCommitmentDefinition('STYLE'));
-    registerCommitment(new StyleCommitmentDefinition('STYLES'));
-    registerCommitment(new RuleCommitmentDefinition('RULE'));
-    registerCommitment(new RuleCommitmentDefinition('RULES'));
-    registerCommitment(new LanguageCommitmentDefinition('LANGUAGE'));
-    registerCommitment(new LanguageCommitmentDefinition('LANGUAGES'));
-    registerCommitment(new SampleCommitmentDefinition('SAMPLE'));
-    registerCommitment(new SampleCommitmentDefinition('EXAMPLE'));
-    registerCommitment(new FormatCommitmentDefinition('FORMAT'));
-    registerCommitment(new FormatCommitmentDefinition('FORMATS'));
-    registerCommitment(new FromCommitmentDefinition('FROM'));
-    registerCommitment(new ModelCommitmentDefinition('MODEL'));
-    registerCommitment(new ModelCommitmentDefinition('MODELS'));
-    registerCommitment(new ActionCommitmentDefinition('ACTION'));
-    registerCommitment(new ActionCommitmentDefinition('ACTIONS'));
-    registerCommitment(new ComponentCommitmentDefinition());
-    registerCommitment(new MetaImageCommitmentDefinition());
-    registerCommitment(new MetaColorCommitmentDefinition());
-    registerCommitment(new MetaLinkCommitmentDefinition());
-    registerCommitment(new MetaCommitmentDefinition());
-    registerCommitment(new NoteCommitmentDefinition('NOTE'));
-    registerCommitment(new NoteCommitmentDefinition('NOTES'));
-    registerCommitment(new NoteCommitmentDefinition('COMMENT'));
-    registerCommitment(new NoteCommitmentDefinition('NONCE'));
-    registerCommitment(new GoalCommitmentDefinition('GOAL'));
-    registerCommitment(new GoalCommitmentDefinition('GOALS'));
-    registerCommitment(new ImportantCommitmentDefinition());
-    registerCommitment(new InitialMessageCommitmentDefinition());
-    registerCommitment(new UserMessageCommitmentDefinition());
-    registerCommitment(new AgentMessageCommitmentDefinition());
-    registerCommitment(new MessageCommitmentDefinition('MESSAGE'));
-    registerCommitment(new MessageCommitmentDefinition('MESSAGES'));
-    registerCommitment(new ScenarioCommitmentDefinition('SCENARIO'));
-    registerCommitment(new ScenarioCommitmentDefinition('SCENARIOS'));
-    registerCommitment(new DeleteCommitmentDefinition('DELETE'));
-    registerCommitment(new DeleteCommitmentDefinition('CANCEL'));
-    registerCommitment(new DeleteCommitmentDefinition('DISCARD'));
-    registerCommitment(new DeleteCommitmentDefinition('REMOVE'));
-    registerCommitment(new OpenCommitmentDefinition());
-    registerCommitment(new ClosedCommitmentDefinition());
-    // Register not yet implemented commitments
-    registerCommitment(new NotYetImplementedCommitmentDefinition('EXPECT'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('BEHAVIOUR'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('BEHAVIOURS'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('AVOID'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('AVOIDANCE'));
-    registerCommitment(new NotYetImplementedCommitmentDefinition('CONTEXT'));
-
     /**
-     * Creates an empty/basic agent model requirements object
-     * This serves as the starting point for the reduce-like pattern
-     * where each commitment applies its changes to build the final requirements
+     * USE commitment definition
      *
-     * @public exported from `@promptbook/core`
-     */
-    function createEmptyAgentModelRequirements() {
-        return {
-            systemMessage: '',
-            // modelName: 'gpt-5',
-            modelName: 'gemini-2.5-flash-lite',
-            temperature: 0.7,
-            topP: 0.9,
-            topK: 50,
-        };
-    }
-    /**
-     * Creates a basic agent model requirements with just the agent name
-     * This is used when we have an agent name but no commitments
+     * The USE commitment indicates that the agent should utilize specific tools or capabilities
+     * to access and interact with external systems when necessary.
      *
-     * @public exported from `@promptbook/core`
-     */
-    function createBasicAgentModelRequirements(agentName) {
-        const empty = createEmptyAgentModelRequirements();
+     * 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.spaceTrim(`
+            # 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.spaceTrim(`
+            # 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.spaceTrim(`
+            # 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.spaceTrim(`
+            # 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
+     *
+     * This commitment simply adds its content 1:1 into the system message,
+     * preserving the original behavior until proper implementation is added.
+     *
+     * @public exported from `@promptbook/core`
+     */
+    class NotYetImplementedCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor(type) {
+            super(type);
+        }
+        /**
+         * Short one-line description of a placeholder commitment.
+         */
+        get description() {
+            return 'Placeholder commitment that appends content verbatim to the system message.';
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🚧';
+        }
+        /**
+         * Markdown documentation available at runtime.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # ${this.type}
+
+            This commitment is not yet fully implemented.
+
+            ## Key aspects
+
+            - Content is appended directly to the system message.
+            - No special processing or validation is performed.
+            - Behavior preserved until proper implementation is added.
+
+            ## Status
+
+            - **Status:** Placeholder implementation
+            - **Effect:** Appends content prefixed by commitment type
+            - **Future:** Will be replaced with specialized logic
+
+            ## Examples
+
+            \`\`\`book
+            Example Agent
+
+            PERSONA You are a helpful assistant
+            ${this.type} Your content here
+            RULE Always be helpful
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            const trimmedContent = content.trim();
+            if (!trimmedContent) {
+                return requirements;
+            }
+            // Add the commitment content 1:1 to the system message
+            const commitmentLine = `${this.type} ${trimmedContent}`;
+            return this.appendToSystemMessage(requirements, commitmentLine, '\n\n');
+        }
+    }
+
+    // Import all commitment definition classes
+    /**
+     * Registry of all available commitment definitions
+     * This array contains instances of all commitment definitions
+     * This is the single source of truth for all commitments in the system
+     *
+     * @private Use functions to access commitments instead of this array directly
+     */
+    const COMMITMENT_REGISTRY = [
+        // Fully implemented commitments
+        new PersonaCommitmentDefinition('PERSONA'),
+        new PersonaCommitmentDefinition('PERSONAE'),
+        new KnowledgeCommitmentDefinition(),
+        new MemoryCommitmentDefinition('MEMORY'),
+        new MemoryCommitmentDefinition('MEMORIES'),
+        new StyleCommitmentDefinition('STYLE'),
+        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'),
+        new NoteCommitmentDefinition('COMMENT'),
+        new NoteCommitmentDefinition('NONCE'),
+        new GoalCommitmentDefinition('GOAL'),
+        new GoalCommitmentDefinition('GOALS'),
+        new InitialMessageCommitmentDefinition(),
+        new UserMessageCommitmentDefinition(),
+        new AgentMessageCommitmentDefinition(),
+        new MessageCommitmentDefinition('MESSAGE'),
+        new MessageCommitmentDefinition('MESSAGES'),
+        new ScenarioCommitmentDefinition('SCENARIO'),
+        new ScenarioCommitmentDefinition('SCENARIOS'),
+        new DeleteCommitmentDefinition('DELETE'),
+        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'),
+        new NotYetImplementedCommitmentDefinition('BEHAVIOURS'),
+        new NotYetImplementedCommitmentDefinition('AVOID'),
+        new NotYetImplementedCommitmentDefinition('AVOIDANCE'),
+        new NotYetImplementedCommitmentDefinition('CONTEXT'),
+    ];
+    /**
+     * Gets a commitment definition by its type
+     * @param type The commitment type to look up
+     * @returns The commitment definition or null if not found
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function getCommitmentDefinition(type) {
+        return COMMITMENT_REGISTRY.find((commitmentDefinition) => commitmentDefinition.type === type) || null;
+    }
+    /**
+     * TODO: [🧠] Maybe create through standardized $register
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
+    /**
+     * Creates an empty/basic agent model requirements object
+     * This serves as the starting point for the reduce-like pattern
+     * where each commitment applies its changes to build the final requirements
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function createEmptyAgentModelRequirements() {
+        return {
+            systemMessage: '',
+            // modelName: 'gpt-5',
+            modelName: 'gemini-2.5-flash-lite',
+            temperature: 0.7,
+            topP: 0.9,
+            topK: 50,
+        };
+    }
+    /**
+     * Creates a basic agent model requirements with just the agent name
+     * This is used when we have an agent name but no commitments
+     *
+     * @public exported from `@promptbook/core`
+     */
+    function createBasicAgentModelRequirements(agentName) {
+        const empty = createEmptyAgentModelRequirements();
         return {
             ...empty,
             systemMessage: `You are ${agentName || 'AI Agent'}`,
@@ -16400,6 +16797,11 @@
      * 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
@@ -16442,7 +16844,7 @@
                         const fullContent = currentCommitment.contentLines.join('\n');
                         commitments.push({
                             type: currentCommitment.type,
-                            content: spaceTrim.spaceTrim(fullContent),
+                            content: spaceTrim$1.spaceTrim(fullContent),
                             originalLine: currentCommitment.originalStartLine,
                             lineNumber: currentCommitment.startLineNumber,
                         });
@@ -16462,6 +16864,24 @@
                     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.spaceTrim(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
@@ -16478,7 +16898,7 @@
             const fullContent = currentCommitment.contentLines.join('\n');
             commitments.push({
                 type: currentCommitment.type,
-                content: spaceTrim.spaceTrim(fullContent),
+                content: spaceTrim$1.spaceTrim(fullContent),
                 originalLine: currentCommitment.originalStartLine,
                 lineNumber: currentCommitment.startLineNumber,
             });
@@ -16977,7 +17397,7 @@
         let trimmedText = text;
         // Remove leading and trailing spaces and newlines
         if (isTrimmed) {
-            trimmedText = spaceTrim.spaceTrim(trimmedText);
+            trimmedText = spaceTrim$1.spaceTrim(trimmedText);
         }
         let processedText = trimmedText;
         if (isIntroduceSentenceRemoved) {
@@ -16986,7 +17406,7 @@
                 // Remove the introduce sentence and quotes by replacing it with an empty string
                 processedText = processedText.replace(introduceSentenceRegex, '');
             }
-            processedText = spaceTrim.spaceTrim(processedText);
+            processedText = spaceTrim$1.spaceTrim(processedText);
         }
         if (processedText.length < 3) {
             return trimmedText;
@@ -17170,6 +17590,10 @@
                 meta.color = spaceTrim__default["default"](commitment.content);
                 continue;
             }
+            if (commitment.type === 'META FONT') {
+                meta.font = spaceTrim__default["default"](commitment.content);
+                continue;
+            }
             if (commitment.type !== 'META') {
                 continue;
             }
@@ -18710,13 +19134,13 @@
      * @public exported from `@promptbook/markdown-utils`
      */
     function trimCodeBlock(value) {
-        value = spaceTrim.spaceTrim(value);
+        value = spaceTrim$1.spaceTrim(value);
         if (!/^```[a-z]*(.*)```$/is.test(value)) {
             return value;
         }
         value = value.replace(/^```[a-z]*/i, '');
         value = value.replace(/```$/i, '');
-        value = spaceTrim.spaceTrim(value);
+        value = spaceTrim$1.spaceTrim(value);
         return value;
     }
 
@@ -18729,9 +19153,9 @@
      * @public exported from `@promptbook/markdown-utils`
      */
     function trimEndOfCodeBlock(value) {
-        value = spaceTrim.spaceTrim(value);
+        value = spaceTrim$1.spaceTrim(value);
         value = value.replace(/```$/g, '');
-        value = spaceTrim.spaceTrim(value);
+        value = spaceTrim$1.spaceTrim(value);
         return value;
     }
 
@@ -21166,7 +21590,7 @@
     function getParserForCommand(command) {
         const commandParser = COMMANDS.find((commandParser) => commandParser.name === command.type);
         if (commandParser === undefined) {
-            throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Command ${command.type} parser is not found
 
                     ${block(JSON.stringify(command, null, 4)
@@ -21242,7 +21666,7 @@
             .map(removeMarkdownFormatting)
             .map((item) => item.trim());
         if (items.length === 0 || items[0] === '') {
-            throw new ParseError(spaceTrim.spaceTrim((block) => `
+            throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                         Malformed command:
                         - ${raw}
 
@@ -21278,7 +21702,7 @@
                 return command;
             }
         }
-        throw new ParseError(spaceTrim.spaceTrim((block) => `
+        throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                   Malformed or unknown command:
                   - ${raw}
 
@@ -21329,7 +21753,7 @@
                     if (!(error instanceof ParseError)) {
                         throw error;
                     }
-                    throw new ParseError(spaceTrim.spaceTrim((block) => `
+                    throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                               Invalid ${commandName} command:
 
                               Your command:
@@ -21645,7 +22069,7 @@
      * @public exported from `@promptbook/markdown-utils`
      */
     function removeMarkdownComments(content) {
-        return spaceTrim.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
+        return spaceTrim$1.spaceTrim(content.replace(/<!--(.*?)-->/gs, ''));
     }
 
     /**
@@ -21930,7 +22354,7 @@
         if (pipelineString.startsWith('#!')) {
             const [shebangLine, ...restLines] = pipelineString.split('\n');
             if (!(shebangLine || '').includes('ptbk')) {
-                throw new ParseError(spaceTrim.spaceTrim((block) => `
+                throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                         It seems that you try to parse a book file which has non-standard shebang line for book files:
                         Shebang line must contain 'ptbk'
 
@@ -21946,7 +22370,7 @@
             pipelineString = validatePipelineString(restLines.join('\n'));
         }
         pipelineString = removeMarkdownComments(pipelineString);
-        pipelineString = spaceTrim.spaceTrim(pipelineString);
+        pipelineString = spaceTrim$1.spaceTrim(pipelineString);
         // <- TODO: [😧] `spaceTrim` should preserve discriminated type *(or at lease `PipelineString`)*
         pipelineString = deflatePipeline(pipelineString);
         // ==============
@@ -21958,7 +22382,7 @@
         // ==============
         // Note: 1️⃣◽4️⃣ Check markdown structure
         if (pipelineHead === undefined) {
-            throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Pipeline head is not defined
 
                     ${block(getPipelineIdentification())}
@@ -21967,7 +22391,7 @@
                 `));
         }
         if (pipelineHead.level !== 1) {
-            throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Pipeline head is not h1
 
                     ${block(getPipelineIdentification())}
@@ -21976,7 +22400,7 @@
                 `));
         }
         if (!pipelineSections.every((section) => section.level === 2)) {
-            throw new UnexpectedError(spaceTrim.spaceTrim((block) => `
+            throw new UnexpectedError(spaceTrim$1.spaceTrim((block) => `
                     Not every pipeline section is h2
 
                     ${block(getPipelineIdentification())}
@@ -21989,7 +22413,7 @@
         const defineParam = (parameterCommand) => {
             const { parameterName, parameterDescription, isInput, isOutput } = parameterCommand;
             if (RESERVED_PARAMETER_NAMES.includes(parameterName)) {
-                throw new ParseError(spaceTrim.spaceTrim((block) => `
+                throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                         Parameter name {${parameterName}} is reserved and cannot be used as resulting parameter name
 
                         ${block(getPipelineIdentification())}
@@ -22000,7 +22424,7 @@
                 existingParameter.description &&
                 existingParameter.description !== parameterDescription &&
                 parameterDescription) {
-                throw new ParseError(spaceTrim.spaceTrim((block) => `
+                throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                         Parameter \`{${parameterName}}\` is defined multiple times with different description:
 
                         ${block(getPipelineIdentification())}
@@ -22038,7 +22462,7 @@
         description = description.split(/^>.*$/gm).join('');
         //Note: Remove lists and return statement - TODO: [🎾] Make util  (exported from `@promptbool/utils`)
         description = description.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-        description = spaceTrim.spaceTrim(description);
+        description = spaceTrim$1.spaceTrim(description);
         if (description === '') {
             description = undefined;
         }
@@ -22049,7 +22473,7 @@
             const command = parseCommand(listItem, 'PIPELINE_HEAD');
             const commandParser = getParserForCommand(command);
             if (commandParser.isUsedInPipelineHead !== true /* <- Note: [🦦][4] */) {
-                throw new ParseError(spaceTrim.spaceTrim((block) => `
+                throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                         Command \`${command.type}\` is not allowed in the head of the pipeline ONLY at the pipeline task
 
                         ${block(getPipelineIdentification())}
@@ -22063,7 +22487,7 @@
                 if (!(error instanceof ParseError)) {
                     throw error;
                 }
-                throw new ParseError(spaceTrim.spaceTrim((block) => `
+                throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                         Command ${command.type} failed to apply to the pipeline
 
                         The error:
@@ -22116,7 +22540,7 @@
             description = description.split(/^>.*$/gm).join('');
             //Note: Remove lists and return statement - TODO: [🎾]
             description = description.split(/^(?:(?:-)|(?:\d\))|(?:`?->))\s+.*$/gm).join('');
-            description = spaceTrim.spaceTrim(description);
+            description = spaceTrim$1.spaceTrim(description);
             if (description === '') {
                 description = undefined;
             }
@@ -22150,7 +22574,7 @@
             for (const { listItem, command } of commands) {
                 const commandParser = getParserForCommand(command);
                 if (commandParser.isUsedInPipelineTask !== true /* <- Note: [🦦][4] */) {
-                    throw new ParseError(spaceTrim.spaceTrim((block) => `
+                    throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                             Command \`${command.type}\` is not allowed in the task of the promptbook ONLY at the pipeline head
 
                             ${block(getPipelineIdentification())}
@@ -22165,7 +22589,7 @@
                     if (!(error instanceof ParseError)) {
                         throw error;
                     }
-                    throw new ParseError(spaceTrim.spaceTrim((block) => `
+                    throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                             Command \`${command.type}\` failed to apply to the task
 
                             The error:
@@ -22196,14 +22620,14 @@
             // TODO: [🍧] Should be done in SECTION command
             if ($taskJson.taskType === 'SCRIPT_TASK') {
                 if (!language) {
-                    throw new ParseError(spaceTrim.spaceTrim((block) => `
+                    throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                             You must specify the language of the script in the \`SCRIPT\` task
 
                             ${block(getPipelineIdentification())}
                         `));
                 }
                 if (!SUPPORTED_SCRIPT_LANGUAGES.includes(language)) {
-                    throw new ParseError(spaceTrim.spaceTrim((block) => `
+                    throw new ParseError(spaceTrim$1.spaceTrim((block) => `
                             Script language ${language} is not supported.
 
                             Supported languages are: