@promptbook/core 0.105.0-6 → 0.105.0-8

package/esm/index.es.js

@@ -27,7 +27,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.105.0-6';
+const PROMPTBOOK_ENGINE_VERSION = '0.105.0-8';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -8525,6 +8525,698 @@ function $getCurrentDate() {
     return new Date().toISOString();
 }
 
+/**
+ * Creates human-readable hash
+ *
+ * @public exported from `@promptbook/utils`
+ */
+async function linguisticHash(input) {
+    const hash = computeHash(input);
+    // Use parts of the hash to select words
+    // SHA256 is 64 hex characters
+    // We use different slices of the hash to ensure variety even with small changes in input
+    const part1 = parseInt(hash.substring(0, 10), 16);
+    const part2 = parseInt(hash.substring(10, 20), 16);
+    const part3 = parseInt(hash.substring(20, 30), 16);
+    const adjective = ADJECTIVES[part1 % ADJECTIVES.length];
+    const noun = NOUNS[part2 % NOUNS.length];
+    const verb = VERBS[part3 % VERBS.length];
+    return `${capitalize(adjective)} ${noun.toLowerCase()} ${verb.toLowerCase()}`;
+}
+const ADJECTIVES = [
+    'red',
+    'blue',
+    'green',
+    'yellow',
+    'quick',
+    'slow',
+    'bright',
+    'dark',
+    'happy',
+    'sad',
+    'brave',
+    'calm',
+    'clever',
+    'eager',
+    'fancy',
+    'grand',
+    'jolly',
+    'kind',
+    'lucky',
+    'nice',
+    'proud',
+    'silly',
+    'wise',
+    'young',
+    'old',
+    'big',
+    'small',
+    'fast',
+    'shiny',
+    'wild',
+    'silent',
+    'loud',
+    'soft',
+    'hard',
+    'warm',
+    'cold',
+    'sweet',
+    'sour',
+    'bitter',
+    'salty',
+    'rich',
+    'poor',
+    'heavy',
+    'light',
+    'strong',
+    'weak',
+    'smooth',
+    'rough',
+    'clean',
+    'dirty',
+    'fresh',
+    'stale',
+    'sharp',
+    'blunt',
+    'thick',
+    'thin',
+    'wide',
+    'narrow',
+    'deep',
+    'shallow',
+    'mighty',
+    'gentle',
+    'fierce',
+    'vibrant',
+    'dusty',
+    'golden',
+    'silver',
+    'frozen',
+    'burning',
+    'ancient',
+    'modern',
+    'hidden',
+    'lost',
+    'found',
+    'magic',
+    'mystic',
+    'cosmic',
+    'stellar',
+    'lunar',
+    'solar',
+    'misty',
+    'foggy',
+    'stormy',
+    'sunny',
+    'windy',
+    'quiet',
+    'noisy',
+    'peaceful',
+    'busy',
+    'empty',
+    'full',
+    'round',
+    'square',
+    'flat',
+    'curved',
+    'tiny',
+    'huge',
+    'giant',
+    'little',
+    'short',
+    'long',
+    'near',
+    'distant',
+    'inner',
+    'outer',
+    'patient',
+    'steady',
+    'noble',
+    'pure',
+    'graceful',
+    'honest',
+    'simple',
+    'complex',
+    'active',
+    'passive',
+    'vivid',
+    'pale',
+    'loyal',
+    'true',
+    'false',
+    'fair',
+    'clear',
+    'murky',
+    'vast',
+    'slick',
+    'slippery',
+    'sticky',
+    'dull',
+    'keen',
+    'broad',
+    'slim',
+    'slender',
+    'fat',
+    'lean',
+    'stiff',
+    'flexible',
+    'rigid',
+    'elastic',
+    'tough',
+    'brittle',
+    'fragile',
+    'solid',
+    'liquid',
+    'gaseous',
+    'airy',
+    'weighty',
+    'buoyant',
+    'dense',
+    'sparse',
+    'hollow',
+    'stuffed',
+    'crowded',
+    'lonely',
+    'social',
+    'private',
+    'public',
+    'secret',
+    'famous',
+    'certain',
+    'vague',
+    'plain',
+    'easy',
+    'tame',
+    'mild',
+    'hot',
+    'cool',
+    'dry',
+    'wet',
+    'damp',
+    'moist',
+    'soaked',
+    'parched',
+    'hungry',
+    'thirsty',
+    'sleepy',
+    'awake',
+    'tired',
+    'lazy',
+    'idle',
+    'swift',
+    'rapid',
+    'unstable',
+    'shaky',
+    'firm',
+    'bold',
+    'timid',
+    'brave',
+    'cowardly',
+    'smart',
+    'dumb',
+    'foolish',
+    'mean',
+    'rude',
+    'tasty',
+    'bland',
+    'arctic',
+    'tropical',
+    'deserted',
+    'urban',
+    'rural',
+    'local',
+    'global',
+    'digital',
+    'analog',
+    'virtual',
+    'real',
+    'fake',
+    'natural',
+    'artificial',
+    'living',
+    'dead',
+    'broken',
+    'fixed',
+    'new',
+    'worn',
+    'neat',
+    'messy',
+    'brave',
+    'fearful',
+    'proud',
+    'humble',
+    'greedy',
+    'generous',
+    'calm',
+    'angry',
+    'happy',
+    'sad',
+    'excited',
+    'bored',
+    'strange',
+    'normal',
+    'odd',
+    'even',
+    'rare',
+    'common',
+    'unique',
+    'plain',
+    'fancy',
+    'basic',
+    'prime',
+    'super',
+    'mega',
+    'ultra',
+    'micro',
+    'nano',
+    'macro',
+    'mini',
+];
+const NOUNS = [
+    'apple',
+    'sky',
+    'tree',
+    'fox',
+    'cat',
+    'bird',
+    'dog',
+    'river',
+    'mountain',
+    'forest',
+    'ocean',
+    'star',
+    'moon',
+    'sun',
+    'cloud',
+    'flower',
+    'leaf',
+    'stone',
+    'wind',
+    'rain',
+    'fire',
+    'ice',
+    'book',
+    'dream',
+    'song',
+    'road',
+    'gate',
+    'key',
+    'lamp',
+    'map',
+    'house',
+    'city',
+    'bridge',
+    'field',
+    'garden',
+    'lake',
+    'beach',
+    'island',
+    'valley',
+    'desert',
+    'world',
+    'spirit',
+    'heart',
+    'mind',
+    'soul',
+    'life',
+    'time',
+    'space',
+    'light',
+    'shadow',
+    'sound',
+    'music',
+    'voice',
+    'word',
+    'page',
+    'story',
+    'pearl',
+    'gold',
+    'silver',
+    'crystal',
+    'diamond',
+    'emerald',
+    'ruby',
+    'path',
+    'trail',
+    'peak',
+    'shore',
+    'wave',
+    'tide',
+    'flame',
+    'spark',
+    'beam',
+    'ray',
+    'seed',
+    'root',
+    'branch',
+    'bloom',
+    'thorn',
+    'bark',
+    'shell',
+    'feather',
+    'wing',
+    'claw',
+    'paw',
+    'nest',
+    'cave',
+    'grove',
+    'tower',
+    'castle',
+    'crown',
+    'sword',
+    'shield',
+    'coin',
+    'gem',
+    'ring',
+    'bell',
+    'clock',
+    'compass',
+    'anchor',
+    'torch',
+    'flute',
+    'harp',
+    'drum',
+    'lens',
+    'glass',
+    'sand',
+    'dust',
+    'mist',
+    'dew',
+    'dawn',
+    'dusk',
+    'night',
+    'day',
+    'year',
+    'age',
+    'bolt',
+    'drop',
+    'storm',
+    'snow',
+    'hail',
+    'fog',
+    'smoke',
+    'vapor',
+    'gas',
+    'fluid',
+    'liquid',
+    'solid',
+    'metal',
+    'rock',
+    'dirt',
+    'clay',
+    'sand',
+    'salt',
+    'sugar',
+    'wood',
+    'bone',
+    'skin',
+    'flesh',
+    'blood',
+    'cell',
+    'atom',
+    'pulse',
+    'beat',
+    'breath',
+    'sigh',
+    'name',
+    'echo',
+    'image',
+    'vision',
+    'thought',
+    'idea',
+    'plan',
+    'goal',
+    'wish',
+    'hope',
+    'fear',
+    'joy',
+    'love',
+    'hate',
+    'will',
+    'power',
+    'force',
+    'energy',
+    'motion',
+    'speed',
+    'place',
+    'point',
+    'line',
+    'shape',
+    'form',
+    'size',
+    'mass',
+    'weight',
+    'heat',
+    'cold',
+    'color',
+    'tone',
+    'pitch',
+    'rhythm',
+    'vibe',
+    'mood',
+    'state',
+    'way',
+    'step',
+    'move',
+    'turn',
+    'fall',
+    'rise',
+    'jump',
+    'leap',
+    'run',
+    'walk',
+    'rest',
+    'stay',
+    'trip',
+    'quest',
+    'task',
+    'work',
+    'job',
+    'play',
+    'game',
+    'sport',
+    'art',
+    'craft',
+    'tool',
+    'ship',
+    'boat',
+    'car',
+    'bike',
+    'train',
+    'plane',
+    'hub',
+    'base',
+    'core',
+    'node',
+    'link',
+    'net',
+    'web',
+    'box',
+    'bag',
+    'jar',
+    'cup',
+    'bowl',
+    'plate',
+    'dish',
+    'spoon',
+    'fork',
+    'knife',
+    'pan',
+    'pot',
+    'bed',
+    'desk',
+    'chair',
+    'door',
+    'wall',
+    'roof',
+    'floor',
+];
+const VERBS = [
+    'jumping',
+    'dancing',
+    'flying',
+    'running',
+    'singing',
+    'shining',
+    'growing',
+    'flowing',
+    'falling',
+    'rising',
+    'sleeping',
+    'walking',
+    'talking',
+    'thinking',
+    'dreaming',
+    'looking',
+    'feeling',
+    'smiling',
+    'laughing',
+    'playing',
+    'working',
+    'resting',
+    'moving',
+    'staying',
+    'beaming',
+    'glowing',
+    'sparkling',
+    'waiting',
+    'waking',
+    'drifting',
+    'spinning',
+    'gliding',
+    'soaring',
+    'floating',
+    'whispering',
+    'calling',
+    'seeking',
+    'finding',
+    'giving',
+    'taking',
+    'weaving',
+    'building',
+    'creating',
+    'burning',
+    'freezing',
+    'melting',
+    'breathing',
+    'pulsing',
+    'beating',
+    'living',
+    'learning',
+    'knowing',
+    'hidden',
+    'shown',
+    'broken',
+    'mended',
+    'lost',
+    'found',
+    'starting',
+    'ending',
+    'climbing',
+    'diving',
+    'swimming',
+    'sailing',
+    'rolling',
+    'shaking',
+    'turning',
+    'shifting',
+    'changing',
+    'fading',
+    'dying',
+    'born',
+    'humming',
+    'crying',
+    'racing',
+    'creeping',
+    'hiding',
+    'watching',
+    'hearing',
+    'sensing',
+    'longing',
+    'hoping',
+    'loving',
+    'fearing',
+    'wondering',
+    'wandering',
+    'traveling',
+    'crossing',
+    'meeting',
+    'parting',
+    'keeping',
+    'sharing',
+    'sparking',
+    'flaming',
+    'healing',
+    'solving',
+    'opening',
+    'closing',
+    'lifting',
+    'pulling',
+    'pushing',
+    'holding',
+    'tossing',
+    'throwing',
+    'catching',
+    'fixing',
+    'making',
+    'doing',
+    'seeing',
+    'tasting',
+    'smelling',
+    'touching',
+    'pacing',
+    'hurrying',
+    'pausing',
+    'going',
+    'coming',
+    'leaving',
+    'acting',
+    'being',
+    'seeming',
+    'shrinking',
+    'widening',
+    'narrowing',
+    'heating',
+    'cooling',
+    'drying',
+    'wetting',
+    'filling',
+    'filling',
+    'emptying',
+    'letting',
+    'gaining',
+    'winning',
+    'failing',
+    'trying',
+    'using',
+    'getting',
+    'showing',
+    'hiding',
+    'breaking',
+    'fixing',
+    'saving',
+    'spending',
+    'buying',
+    'selling',
+    'paying',
+    'costing',
+    'reaching',
+    'missing',
+    'hitting',
+    'striking',
+    'leading',
+    'following',
+    'helping',
+    'serving',
+    'teaching',
+    'training',
+    'coding',
+    'writing',
+    'reading',
+    'drawing',
+    'painting',
+    'crafting',
+    'shaping',
+    'forming',
+    'joining',
+    'splitting',
+    'sharing',
+    'bonding',
+    'healing',
+    'harming',
+    'protecting',
+    'fighting',
+    'defending',
+    'attacking',
+    'escaping',
+    'catching',
+    'trapping',
+    'freeing',
+    'binding',
+    'weaving',
+    'spinning',
+];
+
 /**
  * Function parseNumber will parse number from string
  *
@@ -8633,6 +9325,95 @@ function removeQuotes(text) {
     return text;
 }
 
+/**
+ * Removes quotes and optional introduce text from a string
+ *
+ * Tip: This is very useful for post-processing of the result of the LLM model
+ * Note: This function trims the text and removes whole introduce sentence if it is present
+ * Note: There are two similar functions:
+ * - `removeQuotes` which removes only bounding quotes
+ * - `unwrapResult` which removes whole introduce sentence
+ *
+ * @param text optionally quoted text
+ * @returns text without quotes
+ * @public exported from `@promptbook/utils`
+ */
+function unwrapResult(text, options) {
+    const { isTrimmed = true, isIntroduceSentenceRemoved = true } = options || {};
+    let trimmedText = text;
+    // Remove leading and trailing spaces and newlines
+    if (isTrimmed) {
+        trimmedText = spaceTrim$1(trimmedText);
+    }
+    let processedText = trimmedText;
+    // Check for markdown code block
+    const codeBlockRegex = /^```[a-z]*\n([\s\S]*?)\n```\s*$/;
+    const codeBlockMatch = processedText.match(codeBlockRegex);
+    if (codeBlockMatch && codeBlockMatch[1] !== undefined) {
+        // Check if there's only one code block
+        const codeBlockCount = (processedText.match(/```/g) || []).length / 2;
+        if (codeBlockCount === 1) {
+            return unwrapResult(codeBlockMatch[1], { isTrimmed: false, isIntroduceSentenceRemoved: false });
+        }
+    }
+    if (isIntroduceSentenceRemoved) {
+        const introduceSentenceRegex = /^[a-zěščřžýáíéúů:\s]*:\s*/i;
+        if (introduceSentenceRegex.test(text)) {
+            // Remove the introduce sentence and quotes by replacing it with an empty string
+            processedText = processedText.replace(introduceSentenceRegex, '');
+        }
+        processedText = spaceTrim$1(processedText);
+        // Check again for code block after removing introduce sentence
+        const codeBlockMatch2 = processedText.match(codeBlockRegex);
+        if (codeBlockMatch2 && codeBlockMatch2[1] !== undefined) {
+            const codeBlockCount = (processedText.match(/```/g) || []).length / 2;
+            if (codeBlockCount === 1) {
+                return unwrapResult(codeBlockMatch2[1], { isTrimmed: false, isIntroduceSentenceRemoved: false });
+            }
+        }
+    }
+    if (processedText.length < 3) {
+        return trimmedText;
+    }
+    if (processedText.includes('\n')) {
+        return trimmedText;
+    }
+    // Remove the quotes by extracting the substring without the first and last characters
+    const unquotedText = processedText.slice(1, -1);
+    // Check if the text starts and ends with quotes
+    if ([
+        ['"', '"'],
+        ["'", "'"],
+        ['`', '`'],
+        ['*', '*'],
+        ['_', '_'],
+        ['„', '“'],
+        ['«', '»'] /* <- QUOTES to config */,
+    ].some(([startQuote, endQuote]) => {
+        if (!processedText.startsWith(startQuote)) {
+            return false;
+        }
+        if (!processedText.endsWith(endQuote)) {
+            return false;
+        }
+        if (unquotedText.includes(startQuote) && !unquotedText.includes(endQuote)) {
+            return false;
+        }
+        if (!unquotedText.includes(startQuote) && unquotedText.includes(endQuote)) {
+            return false;
+        }
+        return true;
+    })) {
+        return unwrapResult(unquotedText, { isTrimmed: false, isIntroduceSentenceRemoved: false });
+    }
+    else {
+        return processedText;
+    }
+}
+/**
+ * TODO: [🧠] Should this also unwrap the (parenthesis)
+ */
+
 /**
  * Checks if the given value is a valid JavaScript identifier name.
  *
@@ -11317,6 +12098,46 @@ class UseMcpCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * A search engine implementation that uses the SerpApi to fetch Google search results.
+ *
+ * @private <- TODO: !!!! Export via some package
+ */
+class SerpSearchEngine {
+    get title() {
+        return 'SerpApi Search Engine';
+    }
+    get description() {
+        return 'Search engine that uses SerpApi to fetch Google search results';
+    }
+    checkConfiguration() {
+        if (!process.env.SERP_API_KEY) {
+            throw new Error('SERP_API_KEY is not configured');
+        }
+    }
+    async search(query) {
+        const apiKey = process.env.SERP_API_KEY;
+        if (!apiKey) {
+            throw new Error('SERP_API_KEY is not configured');
+        }
+        const url = new URL('https://serpapi.com/search');
+        url.searchParams.set('q', query);
+        url.searchParams.set('api_key', apiKey);
+        url.searchParams.set('engine', 'google');
+        const response = await fetch(url.toString());
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`SerpApi failed with status ${response.status}: ${response.statusText}\n${body}`);
+        }
+        const data = (await response.json());
+        return (data.organic_results || []).map((item) => ({
+            title: item.title,
+            url: item.link,
+            snippet: item.snippet || '',
+        }));
+    }
+}
+
 /**
  * USE SEARCH ENGINE commitment definition
  *
@@ -11393,18 +12214,13 @@ class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
             ? existingTools
             : [
                 ...existingTools,
-                { type: 'web_search' },
-                // <- Note: [🔰] This is just using simple native search tool by OpenAI @see https://platform.openai.com/docs/guides/tools-web-search
-                //          In future we will use proper MCP search tool:
-                /*
- 
                 {
                     name: 'web_search',
-                    description: spaceTrim(`
-                      Search the internet for information.
-                      Use this tool when you need to find up-to-date information or facts that you don't know.
-                      ${!content ? '' : `Search scope / instructions: ${content}`}
-                  `),
+                    description: spaceTrim$1(`
+                        Search the internet for information.
+                        Use this tool when you need to find up-to-date information or facts that you don't know.
+                        ${!content ? '' : `Search scope / instructions: ${content}`}
+                    `),
                     parameters: {
                         type: 'object',
                         properties: {
@@ -11416,7 +12232,6 @@ class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
                         required: ['query'],
                     },
                 },
-                */
             ];
         // Return requirements with updated tools and metadata
         return {
@@ -11428,6 +12243,33 @@ class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
             },
         };
     }
+    /**
+     * Gets the `web_search` tool function implementation.
+     */
+    getToolFunctions() {
+        return {
+            async web_search(args) {
+                console.log('!!!! [Tool] web_search called', { args });
+                const { query } = args;
+                if (!query) {
+                    throw new Error('Search query is required');
+                }
+                const searchEngine = new SerpSearchEngine();
+                const results = await searchEngine.search(query);
+                return spaceTrim$1((block) => `
+                        Search results for "${query}":
+
+                        ${block(results
+                    .map((result) => spaceTrim$1(`
+                                            - **${result.title}**
+                                              ${result.url}
+                                              ${result.snippet}
+                                        `))
+                    .join('\n\n'))}
+                    `);
+            },
+        };
+    }
 }
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -11671,6 +12513,7 @@ const COMMITMENT_REGISTRY = [
     new NoteCommitmentDefinition('NOTES'),
     new NoteCommitmentDefinition('COMMENT'),
     new NoteCommitmentDefinition('NONCE'),
+    new NoteCommitmentDefinition('TODO'),
     new GoalCommitmentDefinition('GOAL'),
     new GoalCommitmentDefinition('GOALS'),
     new InitialMessageCommitmentDefinition(),
@@ -17647,6 +18490,16 @@ function cacheLlmTools(llmTools, options = {}) {
                 }
             }
         }
+        if (shouldCache && promptResult.toolCalls !== undefined) {
+            // Note: Do not cache results that contain tool calls because they are dynamic and should be always fresh
+            //       For example, it doesn't make sense to cache the message 'What time is it? 3:30 pm' because when the question is asked another time, it can be a different time.
+            shouldCache = false;
+            if (isVerbose) {
+                console.info('Not caching result that contains tool calls for key:', key, {
+                    toolCalls: promptResult.toolCalls,
+                });
+            }
+        }
         if (shouldCache) {
             await storage.setItem(key, {
                 date: $getCurrentDate(),
@@ -20541,8 +21394,7 @@ AgentLlmExecutionTools.assistantCache = new Map();
  * TODO: [🧠] Adding parameter substitution support (here or should be responsibility of the underlying LLM Tools)
  */
 
-var _Agent_instances, _Agent_selfLearnSamples;
-// !!!!! import { RemoteAgent } from './RemoteAgent'; // <- [💞] <- !!!!!
+var _Agent_instances, _Agent_selfLearnNonce, _Agent_selfLearnSamples, _Agent_selfLearnTeacher;
 /**
  * Represents one AI Agent
  *
@@ -20612,6 +21464,7 @@ class Agent extends AgentLlmExecutionTools {
         this.meta = {};
         // TODO: [🐱‍🚀] Add `Agent` simple "mocked" learning by appending to agent source
         // TODO: [🐱‍🚀] Add `Agent` learning by promptbookAgent
+        this.teacherAgent = options.teacherAgent;
         this.agentSource = agentSource;
         this.agentSource.subscribe((source) => {
             this.updateAgentSource(source);
@@ -20682,26 +21535,42 @@ class Agent extends AgentLlmExecutionTools {
         if ((_a = modelRequirements.metadata) === null || _a === void 0 ? void 0 : _a.isClosed) {
             return result;
         }
-        // TODO: !!!!! Is this timed properly?
+        // TODO: !!!!! Return the answer and do the learning asynchronously
+        // Note: [0] Asynchronously add nonce
+        if (just(false)) {
+            await __classPrivateFieldGet(this, _Agent_instances, "m", _Agent_selfLearnNonce).call(this);
+        }
         // Note: [1] Do the append of the samples
-        __classPrivateFieldGet(this, _Agent_instances, "m", _Agent_selfLearnSamples).call(this, prompt, result);
-        /*
-        !!!!!
+        await __classPrivateFieldGet(this, _Agent_instances, "m", _Agent_selfLearnSamples).call(this, prompt, result);
         // Note: [2] Asynchronously call the teacher agent and invoke the silver link. When the teacher fails, keep just the samples
-        this.#selfLearnTeacher(prompt, result).catch((error) => {
-            if (this.options.isVerbose) {
-                console.error('Failed to self-learn from teacher agent', error);
-            }
+        await __classPrivateFieldGet(this, _Agent_instances, "m", _Agent_selfLearnTeacher).call(this, prompt, result).catch((error) => {
+            // !!!!! if (this.options.isVerbose) {
+            console.error(colors.bgCyan('[Self-learning]') + colors.red(' Failed to learn from teacher agent'));
+            console.error(error);
+            // }
         });
-        */
         return result;
     }
 }
-_Agent_instances = new WeakSet(), _Agent_selfLearnSamples = function _Agent_selfLearnSamples(prompt, result) {
+_Agent_instances = new WeakSet(), _Agent_selfLearnNonce = 
+/**
+ * Self-learning Step 0: Asynchronously with random timing add nonce to the agent source
+ */
+async function _Agent_selfLearnNonce() {
+    await forTime(Math.random() * 5000);
+    // <- TODO: [🕓] `await forRandom(...)`
+    console.info(colors.bgCyan('[Self-learning]') + colors.cyan(' Nonce'));
+    const nonce = `NONCE ${await linguisticHash(Math.random().toString())}`;
+    // Append to the current source
+    const currentSource = this.agentSource.value;
+    const newSource = padBook(validateBook(spaceTrim$2(currentSource) + '\n\n---\n\n' + nonce));
+    // <- TODO: [🈲] Use some object-based way how to append on book (with sections `---`)
+    // Update the source (which will trigger the subscription and update the underlying tools)
+    this.agentSource.next(newSource);
+}, _Agent_selfLearnSamples = function _Agent_selfLearnSamples(prompt, result) {
+    console.info(colors.bgCyan('[Self-learning]') + colors.cyan(' Sampling'));
     const learningExample = spaceTrim$2((block) => `
 
-                ---
-
                 USER MESSAGE
                 ${block(prompt.content)}
 
@@ -20711,9 +21580,80 @@ _Agent_instances = new WeakSet(), _Agent_selfLearnSamples = function _Agent_self
             `);
     // Append to the current source
     const currentSource = this.agentSource.value;
-    const newSource = padBook(validateBook(spaceTrim$2(currentSource) + '\n\n' + learningExample));
+    const newSource = padBook(validateBook(spaceTrim$2(currentSource) + '\n\n---\n\n' + learningExample));
+    // <- TODO: [🈲] Use some object-based way how to append on book (with sections `---`)
     // Update the source (which will trigger the subscription and update the underlying tools)
     this.agentSource.next(newSource);
+}, _Agent_selfLearnTeacher = 
+/**
+ * Self-learning Step 2: Asynchronously call the teacher agent and invoke the silver link
+ */
+async function _Agent_selfLearnTeacher(prompt, result) {
+    // [1] Call the teacher agent // <- !!!!! Emojis
+    if (this.teacherAgent === null) {
+        return;
+    }
+    console.info(colors.bgCyan('[Self-learning]') + colors.cyan(' Teacher'));
+    const teacherResult = await this.teacherAgent.callChatModel({
+        title: 'Self-learning',
+        modelRequirements: {
+            modelVariant: 'CHAT',
+        },
+        // TODO: !!!! Use prompt notation
+        content: spaceTrim$2((block) => `
+
+                    You are a teacher agent helping another agent to learn from its interactions.
+
+                    Here is your current client which you are teaching:
+
+                    \`\`\`book
+                    ${block(this.agentSource.value)}
+                    \`\`\`
+
+                    **And here is the latest interaction:**
+
+                    **User:**
+                    ${block(prompt.content)}
+
+                    **Agent:**
+                    ${block(result.content)}
+
+
+                    **Rules:**
+
+                    - Decide what the agent should learn from this interaction.
+                    - Append new commitments at the end of the agent source.
+                    - Do not modify the current agent source, just return new commitments (KNOWLEDGE, RULE, etc.).
+                    - If there is nothing new to learn, return empty book code block
+                    - Wrap the commitments in a book code block.
+                    - Do not explain anything, just return the commitments wrapped in a book code block.
+                    - Write the learned commitments in the same style and language as in the original agent source.
+
+
+                    This is how book code block looks like:
+
+                    \`\`\`book
+                    KNOWLEDGE The sky is blue.
+                    RULE Always be polite.
+                    \`\`\`
+                `),
+        // pipelineUrl: 'https://github.com/webgptorg/promptbook/blob/main/prompts/self-learning.ptbk.md',
+        // <- TODO: !!!! Remove and `pipelineUrl` for agent purposes
+        parameters: {},
+    });
+    console.log('!!!! teacherResult', teacherResult);
+    const teacherCommitments = unwrapResult(teacherResult.content);
+    if (teacherCommitments === '') {
+        console.info(colors.bgCyan('[Self-learning]') +
+            colors.cyan(' Teacher agent did not provide new commitments to learn'));
+        return;
+    }
+    // [2] Append to the current source
+    const currentSource = this.agentSource.value;
+    const newSource = padBook(validateBook(spaceTrim$2(currentSource) + '\n\n' + teacherCommitments));
+    // <- TODO: [🈲] Use some object-based way how to append on book (with sections `---`)
+    // [3] Update the source
+    this.agentSource.next(newSource);
 };
 /**
  * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
@@ -20857,10 +21797,25 @@ function book(strings, ...values) {
  */
 class RemoteAgent extends Agent {
     static async connect(options) {
-        console.log('[🐱‍🚀]', `${options.agentUrl}/api/profile`);
-        const profileResponse = await fetch(`${options.agentUrl}/api/profile`);
+        const agentProfileUrl = `${options.agentUrl}/api/profile`;
+        const profileResponse = await fetch(agentProfileUrl);
         // <- TODO: [🐱‍🚀] What about closed-source agents?
         // <- TODO: [🐱‍🚀] Maybe use promptbookFetch
+        if (!profileResponse.ok) {
+            throw new Error(spaceTrim$2((block) => `
+                        Failed to fetch remote agent profile:
+
+                        Agent URL:
+                        ${options.agentUrl}
+
+                        Agent Profile URL:
+                        ${agentProfileUrl}
+                        
+                        Http Error:
+                        ${block(profileResponse.statusText)}
+                
+                `));
+        }
         const profile = await profileResponse.json();
         // Note: We are creating dummy agent source because we don't have the source from the remote agent
         //       But we populate the metadata from the profile
@@ -20887,6 +21842,7 @@ class RemoteAgent extends Agent {
             */
             },
             agentSource,
+            teacherAgent: null, // <- Note:
         });
         remoteAgent._remoteAgentName = profile.agentName;
         remoteAgent._remoteAgentHash = profile.agentHash;
@@ -22626,10 +23582,11 @@ function $generateBookBoilerplate(options) {
     const agentSource = validateBook(spaceTrim$2((block) => `
                 ${agentName}
     
-                META COLOR ${color || PROMPTBOOK_COLOR.toHex()}
+                
                 PERSONA ${block(personaDescription)}
                 ${block(initialRules.map((rule) => `RULE ${rule}`).join('\n'))}
             `));
+    // Note: `META COLOR ${color || PROMPTBOOK_COLOR.toHex()}` was removed for now
     // Note: `META FONT Playfair Display, sans-serif` was removed for now
     // <- TODO: [🈲] Simple and object-constructive way how to create new books
     return agentSource;