@promptbook/core 0.103.0-51 → 0.103.0-53

package/esm/index.es.js

@@ -27,12 +27,23 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-51';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-53';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * Core Promptbook server configuration.
+ *
+ * This server is also used for auto-federation in the Agents Server.
+ */
+const CORE_SERVER = {
+    title: 'Promptbook Core',
+    description: `Core Promptbook server used for auto-federation`,
+    owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
+    urls: ['https://core.ptbk.io/'],
+};
 /**
  * Available remote servers for the Promptbook
  *
@@ -54,6 +65,7 @@ const REMOTE_SERVER_URLS = [
         owner: 'AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)',
         urls: ['https://s6.ptbk.io/'],
     },
+    CORE_SERVER,
     /*
     Note: Working on older version of Promptbook and not supported anymore
     {
@@ -66,7 +78,14 @@ const REMOTE_SERVER_URLS = [
     */
 ];
 /**
- * TODO: [🐱‍🚀] Auto-federated server from url in here
+ * Remote servers that are auto-federated by the Agents Server.
+ *
+ * These servers are always added in addition to the `FEDERATED_SERVERS` metadata.
+ *
+ * @public exported from `@promptbook/core`
+ */
+const AUTO_FEDERATED_AGENT_SERVER_URLS = CORE_SERVER.urls;
+/**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
@@ -7444,9 +7463,13 @@ async function preparePersona(personaDescription, tools, options) {
  *
  * @private - TODO: [🧠] Maybe should be public?
  */
-function createCommitmentRegex(commitment) {
-    const escapedCommitment = commitment.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    const keywordPattern = escapedCommitment.split(/\s+/).join('\\s+');
+function createCommitmentRegex(commitment, aliases = []) {
+    const allCommitments = [commitment, ...aliases];
+    const patterns = allCommitments.map((c) => {
+        const escapedCommitment = c.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        return escapedCommitment.split(/\s+/).join('\\s+');
+    });
+    const keywordPattern = patterns.join('|');
     const regex = new RegExp(`^\\s*(?<type>${keywordPattern})\\b\\s+(?<contents>.+)$`, 'gim');
     return regex;
 }
@@ -7459,9 +7482,13 @@ function createCommitmentRegex(commitment) {
  *
  * @private
  */
-function createCommitmentTypeRegex(commitment) {
-    const escapedCommitment = commitment.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    const keywordPattern = escapedCommitment.split(/\s+/).join('\\s+');
+function createCommitmentTypeRegex(commitment, aliases = []) {
+    const allCommitments = [commitment, ...aliases];
+    const patterns = allCommitments.map((c) => {
+        const escapedCommitment = c.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        return escapedCommitment.split(/\s+/).join('\\s+');
+    });
+    const keywordPattern = patterns.join('|');
     const regex = new RegExp(`^\\s*(?<type>${keywordPattern})\\b`, 'gim');
     return regex;
 }
@@ -7473,22 +7500,23 @@ function createCommitmentTypeRegex(commitment) {
  * @private
  */
 class BaseCommitmentDefinition {
-    constructor(type) {
+    constructor(type, aliases = []) {
         this.type = type;
+        this.aliases = aliases;
     }
     /**
      * Creates a regex pattern to match this commitment in agent source
      * Uses the existing createCommitmentRegex function as internal helper
      */
     createRegex() {
-        return createCommitmentRegex(this.type);
+        return createCommitmentRegex(this.type, this.aliases);
     }
     /**
      * Creates a regex pattern to match just the commitment type
      * Uses the existing createCommitmentTypeRegex function as internal helper
      */
     createTypeRegex() {
-        return createCommitmentTypeRegex(this.type);
+        return createCommitmentTypeRegex(this.type, this.aliases);
     }
     /**
      * Helper method to create a new requirements object with updated system message
@@ -8099,6 +8127,77 @@ class MemoryCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * AGENT MESSAGE commitment definition
+ *
+ * The AGENT MESSAGE commitment defines a message from the agent in the conversation history.
+ * It is used to pre-fill the chat with a conversation history or to provide few-shot examples.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * AGENT MESSAGE What seems to be the issue?
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class AgentMessageCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('AGENT MESSAGE');
+    }
+    /**
+     * Short one-line description of AGENT MESSAGE.
+     */
+    get description() {
+        return 'Defines a **message from the agent** in the conversation history.';
+    }
+    /**
+     * Markdown documentation for AGENT MESSAGE commitment.
+     */
+    get documentation() {
+        return spaceTrim$2(`
+            # ${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.
+
+            ## Key aspects
+
+            - Represents a message sent by the agent.
+            - Used for setting up conversation context.
+            - Can be used in conjunction with USER MESSAGE.
+
+            ## Examples
+
+            \`\`\`book
+            Conversation History
+
+            USER MESSAGE Hello, I have a problem.
+            AGENT MESSAGE What seems to be the issue?
+            USER MESSAGE My computer is not starting.
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // AGENT MESSAGE is for UI display purposes / conversation history construction
+        // and typically doesn't need to be added to the system prompt or model requirements directly.
+        // It is extracted separately for the chat interface.
+        var _a;
+        const pendingUserMessage = (_a = requirements.metadata) === null || _a === void 0 ? void 0 : _a.pendingUserMessage;
+        if (pendingUserMessage) {
+            const newSample = { question: pendingUserMessage, answer: content };
+            const newSamples = [...(requirements.samples || []), newSample];
+            const newMetadata = { ...requirements.metadata };
+            delete newMetadata.pendingUserMessage;
+            return {
+                ...requirements,
+                samples: newSamples,
+                metadata: newMetadata,
+            };
+        }
+        return requirements;
+    }
+}
+
 /**
  * INITIAL MESSAGE commitment definition
  *
@@ -8263,6 +8362,67 @@ class MessageCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * USER MESSAGE commitment definition
+ *
+ * The USER MESSAGE commitment defines a message from the user in the conversation history.
+ * It is used to pre-fill the chat with a conversation history or to provide few-shot examples.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * USER MESSAGE Hello, I have a problem.
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class UserMessageCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('USER MESSAGE');
+    }
+    /**
+     * Short one-line description of USER MESSAGE.
+     */
+    get description() {
+        return 'Defines a **message from the user** in the conversation history.';
+    }
+    /**
+     * Markdown documentation for USER MESSAGE commitment.
+     */
+    get documentation() {
+        return spaceTrim$2(`
+            # ${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.
+
+            ## Key aspects
+
+            - Represents a message sent by the user.
+            - Used for setting up conversation context.
+            - Can be used in conjunction with AGENT MESSAGE.
+
+            ## Examples
+
+            \`\`\`book
+            Conversation History
+
+            USER MESSAGE Hello, I have a problem.
+            AGENT MESSAGE What seems to be the issue?
+            USER MESSAGE My computer is not starting.
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        return {
+            ...requirements,
+            metadata: {
+                ...requirements.metadata,
+                pendingUserMessage: content,
+            },
+        };
+    }
+}
+
 /**
  * META commitment definition
  *
@@ -8400,6 +8560,165 @@ class MetaCommitmentDefinition extends BaseCommitmentDefinition {
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * META COLOR commitment definition
+ *
+ * The META COLOR commitment sets the agent's accent color.
+ * 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 COLOR #ff0000
+ * META COLOR #00ff00
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class MetaColorCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('META COLOR', ['COLOR']);
+    }
+    /**
+     * Short one-line description of META COLOR.
+     */
+    get description() {
+        return "Set the agent's accent color.";
+    }
+    /**
+     * Markdown documentation for META COLOR commitment.
+     */
+    get documentation() {
+        return spaceTrim$2(`
+            # META COLOR
+
+            Sets the agent's accent color.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - 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.
+
+            ## Examples
+
+            \`\`\`book
+            Professional Assistant
+
+            META COLOR #3498db
+            PERSONA You are a professional business assistant
+            \`\`\`
+
+            \`\`\`book
+            Creative Helper
+
+            META COLOR #e74c3c
+            PERSONA You are a creative and inspiring assistant
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // META COLOR doesn't modify the system message or model requirements
+        // It's handled separately in the parsing logic for profile color extraction
+        // This method exists for consistency with the CommitmentDefinition interface
+        return requirements;
+    }
+    /**
+     * Extracts the profile color from the content
+     * This is used by the parsing logic
+     */
+    extractProfileColor(content) {
+        const trimmedContent = content.trim();
+        return trimmedContent || null;
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * META IMAGE commitment definition
+ *
+ * The META IMAGE commitment sets the agent's avatar/profile image URL.
+ * This commitment is special because it doesn't affect the system message,
+ * but is handled separately in the parsing logic.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * META IMAGE https://example.com/avatar.jpg
+ * META IMAGE /assets/agent-avatar.png
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('META IMAGE', ['IMAGE']);
+    }
+    /**
+     * Short one-line description of META IMAGE.
+     */
+    get description() {
+        return "Set the agent's profile image URL.";
+    }
+    /**
+     * Markdown documentation for META IMAGE commitment.
+     */
+    get documentation() {
+        return spaceTrim$2(`
+            # META IMAGE
+
+            Sets the agent's avatar/profile image URL.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - Only one \`META IMAGE\` should be used per agent.
+            - If multiple are specified, the last one takes precedence.
+            - Used for visual representation in user interfaces.
+
+            ## Examples
+
+            \`\`\`book
+            Professional Assistant
+
+            META IMAGE https://example.com/professional-avatar.jpg
+            PERSONA You are a professional business assistant
+            STYLE Maintain a formal and courteous tone
+            \`\`\`
+
+            \`\`\`book
+            Creative Helper
+
+            META IMAGE /assets/creative-bot-avatar.png
+            PERSONA You are a creative and inspiring assistant
+            STYLE Be enthusiastic and encouraging
+            ACTION Can help with brainstorming and ideation
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // META IMAGE doesn't modify the system message or model requirements
+        // It's handled separately in the parsing logic for profile image extraction
+        // This method exists for consistency with the CommitmentDefinition interface
+        return requirements;
+    }
+    /**
+     * Extracts the profile image URL from the content
+     * This is used by the parsing logic
+     */
+    extractProfileImageUrl(content) {
+        const trimmedContent = content.trim();
+        return trimmedContent || null;
+    }
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * MODEL commitment definition
  *
@@ -9307,6 +9626,8 @@ const COMMITMENT_REGISTRY = [
     new ModelCommitmentDefinition('MODELS'),
     new ActionCommitmentDefinition('ACTION'),
     new ActionCommitmentDefinition('ACTIONS'),
+    new MetaImageCommitmentDefinition(),
+    new MetaColorCommitmentDefinition(),
     new MetaCommitmentDefinition(),
     new NoteCommitmentDefinition('NOTE'),
     new NoteCommitmentDefinition('NOTES'),
@@ -9315,6 +9636,8 @@ const COMMITMENT_REGISTRY = [
     new GoalCommitmentDefinition('GOAL'),
     new GoalCommitmentDefinition('GOALS'),
     new InitialMessageCommitmentDefinition(),
+    new UserMessageCommitmentDefinition(),
+    new AgentMessageCommitmentDefinition(),
     new MessageCommitmentDefinition('MESSAGE'),
     new MessageCommitmentDefinition('MESSAGES'),
     new ScenarioCommitmentDefinition('SCENARIO'),
@@ -9369,6 +9692,45 @@ function getAllCommitmentTypes() {
 function isCommitmentSupported(type) {
     return COMMITMENT_REGISTRY.some((commitmentDefinition) => commitmentDefinition.type === type);
 }
+/**
+ * Gets all commitment definitions grouped by their aliases
+ *
+ * @returns Array of grouped commitment definitions
+ *
+ * @public exported from `@promptbook/core`
+ */
+function getGroupedCommitmentDefinitions() {
+    const groupedCommitments = [];
+    for (const commitment of COMMITMENT_REGISTRY) {
+        const lastGroup = groupedCommitments[groupedCommitments.length - 1];
+        // Check if we should group with the previous item
+        let shouldGroup = false;
+        if (lastGroup) {
+            const lastPrimary = lastGroup.primary;
+            // Case 1: Same class constructor (except NotYetImplemented)
+            if (!(commitment instanceof NotYetImplementedCommitmentDefinition) &&
+                commitment.constructor === lastPrimary.constructor) {
+                shouldGroup = true;
+            }
+            // Case 2: NotYetImplemented with prefix matching (e.g. BEHAVIOUR -> BEHAVIOURS)
+            else if (commitment instanceof NotYetImplementedCommitmentDefinition &&
+                lastPrimary instanceof NotYetImplementedCommitmentDefinition &&
+                commitment.type.startsWith(lastPrimary.type)) {
+                shouldGroup = true;
+            }
+        }
+        if (shouldGroup && lastGroup) {
+            lastGroup.aliases.push(commitment.type);
+        }
+        else {
+            groupedCommitments.push({
+                primary: commitment,
+                aliases: [],
+            });
+        }
+    }
+    return $deepFreeze(groupedCommitments);
+}
 /**
  * TODO: [🧠] Maybe create through standardized $register
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -10108,6 +10470,18 @@ function parseNumber(value) {
  * TODO: [🧠][🌻] Maybe export through `@promptbook/markdown-utils` not `@promptbook/utils`
  */
 
+/**
+ * Normalizes message text for comparison
+ *
+ * @param text The message text to normalize
+ * @returns The normalized message text
+ *
+ * @public exported from `@promptbook/utils`
+ */
+function normalizeMessageText(text) {
+    return spaceTrim$2(text);
+}
+
 /**
  * Removes quotes from a string
  *
@@ -10220,6 +10594,14 @@ function parseAgentSource(agentSource) {
             links.push(spaceTrim$1(commitment.content));
             continue;
         }
+        if (commitment.type === 'META IMAGE') {
+            meta.image = spaceTrim$1(commitment.content);
+            continue;
+        }
+        if (commitment.type === 'META COLOR') {
+            meta.color = spaceTrim$1(commitment.content);
+            continue;
+        }
         if (commitment.type !== 'META') {
             continue;
         }
@@ -10235,6 +10617,10 @@ function parseAgentSource(agentSource) {
     if (!meta.image) {
         meta.image = generatePlaceholderAgentProfileImageUrl(parseResult.agentName || '!!');
     }
+    // Generate fullname fallback if no meta fullname specified
+    if (!meta.fullname) {
+        meta.fullname = parseResult.agentName || createDefaultAgentName(agentSource);
+    }
     // Parse parameters using unified approach - both @Parameter and {parameter} notations
     // are treated as the same syntax feature with unified representation
     const parameters = parseParameters(agentSource);
@@ -10600,7 +10986,96 @@ class AgentCollectionInSupabase /* TODO: [🐱‍🚀] implements Agent */ {
      * Deletes an agent from the collection
      */
     async deleteAgent(agentName) {
-        throw new NotYetImplementedError('Method not implemented.');
+        const deleteResult = await this.supabaseClient
+            .from(this.getTableName('Agent'))
+            .delete()
+            .eq('agentName', agentName);
+        if (deleteResult.error) {
+            throw new DatabaseError(spaceTrim((block) => `
+                        Error deleting agent "${agentName}" from Supabase:
+                        
+                        ${block(deleteResult.error.message)}
+                    `));
+        }
+    }
+    /**
+     * List history of an agent
+     */
+    async listAgentHistory(agentName) {
+        const result = await this.supabaseClient
+            .from(this.getTableName('AgentHistory'))
+            .select('id, createdAt, agentHash, promptbookEngineVersion')
+            .eq('agentName', agentName)
+            .order('createdAt', { ascending: false });
+        if (result.error) {
+            throw new DatabaseError(spaceTrim((block) => `
+                    Error listing history for agent "${agentName}" from Supabase:
+                    
+                    ${block(result.error.message)}
+                `));
+        }
+        return result.data;
+    }
+    /**
+     * List agents that are in history but not in the active agents list
+     */
+    async listDeletedAgents() {
+        const historyNamesResult = await this.supabaseClient.from(this.getTableName('AgentHistory')).select('agentName');
+        const currentNamesResult = await this.supabaseClient.from(this.getTableName('Agent')).select('agentName');
+        if (historyNamesResult.error) {
+            throw new DatabaseError(spaceTrim((block) => `
+                    Error fetching agent history names from Supabase:
+                    
+                    ${block(historyNamesResult.error.message)}
+                `));
+        }
+        if (currentNamesResult.error) {
+            throw new DatabaseError(spaceTrim((block) => `
+                    Error fetching current agent names from Supabase:
+                    
+                    ${block(currentNamesResult.error.message)}
+                `));
+        }
+        const currentNames = new Set(currentNamesResult.data.map((d) => d.agentName));
+        const deletedNames = new Set();
+        for (const { agentName } of historyNamesResult.data) {
+            if (!currentNames.has(agentName)) {
+                deletedNames.add(agentName);
+            }
+        }
+        return Array.from(deletedNames);
+    }
+    /**
+     * Restore an agent from history
+     */
+    async restoreAgent(historyId) {
+        const historyResult = await this.supabaseClient
+            .from(this.getTableName('AgentHistory'))
+            .select('*')
+            .eq('id', historyId)
+            .single();
+        if (historyResult.error) {
+            throw new DatabaseError(spaceTrim((block) => `
+                    Error fetching agent history item "${historyId}" from Supabase:
+                    
+                    ${block(historyResult.error.message)}
+                `));
+        }
+        const { agentName, agentSource } = historyResult.data;
+        // Check if agent exists
+        const agentResult = await this.supabaseClient
+            .from(this.getTableName('Agent'))
+            .select('id')
+            .eq('agentName', agentName)
+            .single();
+        if (agentResult.data) {
+            // Update
+            await this.updateAgentSource(agentName, agentSource);
+        }
+        else {
+            // Insert (Restore from deleted)
+            await this.createAgent(agentSource);
+        }
     }
     /**
      * Get the Supabase table name with prefix
@@ -17029,12 +17504,15 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                         fileStreams.push(file);
                     }
                     else {
+                        /*
+                        TODO: [🐱‍🚀] Resolve problem with browser environment
                         // Assume it's a local file path
                         // Note: This will work in Node.js environment
                         // For browser environments, this would need different handling
                         const fs = await import('fs');
                         const fileStream = fs.createReadStream(source);
                         fileStreams.push(fileStream);
+                        */
                     }
                 }
                 catch (error) {
@@ -17123,12 +17601,15 @@ class OpenAiAssistantExecutionTools extends OpenAiExecutionTools {
                         fileStreams.push(file);
                     }
                     else {
+                        /*
+                        TODO: [🐱‍🚀] Resolve problem with browser environment
                         // Assume it's a local file path
                         // Note: This will work in Node.js environment
                         // For browser environments, this would need different handling
                         const fs = await import('fs');
                         const fileStream = fs.createReadStream(source);
                         fileStreams.push(fileStream);
+                        */
                     }
                 }
                 catch (error) {
@@ -17264,7 +17745,7 @@ class AgentLlmExecutionTools {
     }
     get title() {
         const agentInfo = this.getAgentInfo();
-        return (agentInfo.agentName || 'Agent');
+        return (agentInfo.meta.fullname || agentInfo.agentName || 'Agent');
     }
     get description() {
         const agentInfo = this.getAgentInfo();
@@ -17277,7 +17758,7 @@ class AgentLlmExecutionTools {
         }
         return {
             name: agentInfo.agentName.toUpperCase().replace(/\s+/g, '_'),
-            fullname: agentInfo.agentName,
+            fullname: agentInfo.meta.fullname || agentInfo.agentName,
             color: agentInfo.meta.color || '#6366f1',
             avatarSrc: agentInfo.meta.image,
         };
@@ -17502,19 +17983,63 @@ class Agent extends AgentLlmExecutionTools {
      * Note: This method also implements the learning mechanism
      */
     async callChatModelStream(prompt, onProgress) {
+        // [1] Check if the user is asking the same thing as in the samples
+        const modelRequirements = await this.getAgentModelRequirements();
+        if (modelRequirements.samples) {
+            const normalizedPrompt = normalizeMessageText(prompt.content);
+            const sample = modelRequirements.samples.find((s) => normalizeMessageText(s.question) === normalizedPrompt);
+            if (sample) {
+                const now = new Date().toISOString();
+                const result = {
+                    content: sample.answer,
+                    modelName: this.modelName,
+                    timing: {
+                        start: now,
+                        complete: now,
+                    },
+                    usage: {
+                        price: { value: 0, isUncertain: true },
+                        input: {
+                            tokensCount: { value: 0, isUncertain: true },
+                            charactersCount: { value: 0, isUncertain: true },
+                            wordsCount: { value: 0, isUncertain: true },
+                            linesCount: { value: 0, isUncertain: true },
+                            sentencesCount: { value: 0, isUncertain: true },
+                            paragraphsCount: { value: 0, isUncertain: true },
+                            pagesCount: { value: 0, isUncertain: true },
+                        },
+                        output: {
+                            tokensCount: { value: 0, isUncertain: true },
+                            charactersCount: { value: 0, isUncertain: true },
+                            wordsCount: { value: 0, isUncertain: true },
+                            linesCount: { value: 0, isUncertain: true },
+                            sentencesCount: { value: 0, isUncertain: true },
+                            paragraphsCount: { value: 0, isUncertain: true },
+                            pagesCount: { value: 0, isUncertain: true },
+                        },
+                    },
+                    rawPromptContent: prompt.content,
+                    rawRequest: null,
+                    rawResponse: { sample },
+                };
+                onProgress(result);
+                return result;
+            }
+        }
         const result = await super.callChatModelStream(prompt, onProgress);
+        if (result.rawResponse && 'sample' in result.rawResponse) {
+            return result;
+        }
         // TODO: !!! Extract learning to separate method
         // Learning: Append the conversation sample to the agent source
         const learningExample = spaceTrim$1((block) => `
 
                 ---
 
-                SAMPLE
-
-                User:
+                USER MESSAGE
                 ${block(prompt.content)}
 
-                ${this.title} (Me, the Agent):
+                AGENT MESSAGE
                 ${block(result.content)}
 
             `);
@@ -17590,6 +18115,70 @@ const _AgentRegistration = $llmToolsRegister.register(createAgentLlmExecutionToo
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */
 
+/**
+ * Function `isValidPipelineString` will validate the if the string is a valid pipeline string
+ * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
+ *
+ * @param {string} pipelineString the candidate for a pipeline string
+ * @returns {boolean} if the string is a valid pipeline string
+ * @public exported from `@promptbook/core`
+ */
+function isValidPipelineString(pipelineString) {
+    try {
+        validatePipelineString(pipelineString);
+        return true;
+    }
+    catch (error) {
+        assertsError(error);
+        return false;
+    }
+}
+/**
+ * TODO: [🧠][🈴] Where is the best location for this file
+ */
+
+/**
+ * Tag function for notating a pipeline with a book\`...\ notation as template literal
+ *
+ * Note: There are 3 similar functions:
+ * 1) `prompt` for notating single prompt exported from `@promptbook/utils`
+ * 2) `promptTemplate` alias for `prompt`
+ * 3) `book` for notating and validating entire books exported from `@promptbook/utils`
+ *
+ * @param strings The static string parts of the template literal
+ * @param values The dynamic values embedded within the template literal used as data
+ * @returns the pipeline string
+ * @public exported from `@promptbook/core`
+ */
+function book(strings, ...values) {
+    const bookString = prompt(strings, ...values);
+    if (!isValidPipelineString(bookString)) {
+        // TODO: Make the CustomError for this
+        throw new Error(spaceTrim$1(`
+                The string is not a valid pipeline string
+
+                book\`
+                    ${bookString}
+                \`
+            `));
+    }
+    if (!isValidBook(bookString)) {
+        // TODO: Make the CustomError for this
+        throw new Error(spaceTrim$1(`
+                The string is not a valid book
+
+                book\`
+                    ${bookString}
+                \`
+            `));
+    }
+    return padBook(bookString);
+}
+/**
+ * TODO: [🧠][🈴] Where is the best location for this file
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
 /**
  * Represents one AI Agent
  *
@@ -17611,11 +18200,12 @@ class RemoteAgent extends Agent {
         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
-        const agentSource = new BehaviorSubject(`
-# ${profile.agentName}
+        const agentSource = new BehaviorSubject(book `
+            ${profile.agentName}
 
-${profile.personaDescription}
+            ${profile.personaDescription}
         `);
+        // <- TODO: [🐱‍🚀] createBookFromProfile
         // <- TODO: [🐱‍🚀] Support updating and self-updating
         const remoteAgent = new RemoteAgent({
             ...options,
@@ -17640,10 +18230,12 @@ ${profile.personaDescription}
         remoteAgent.initialMessage = profile.initialMessage;
         remoteAgent.links = profile.links;
         remoteAgent.meta = profile.meta;
+        remoteAgent._isVoiceCallingEnabled = profile.isVoiceCallingEnabled === true; // [✨✷] Store voice calling status
         return remoteAgent;
     }
     constructor(options) {
         super(options);
+        this._isVoiceCallingEnabled = false; // [✨✷] Track voice calling status
         this.agentUrl = options.agentUrl;
     }
     get agentName() {
@@ -17659,8 +18251,49 @@ ${profile.personaDescription}
         return this.callChatModelStream(prompt, () => { });
     }
     /**
-     * Calls the agent on agents remote server with streaming
+     * Calls the agent on agents remote server with voice
+     * [✨✷] Only available when voice calling is enabled on the server
+     * Returns undefined if voice calling is disabled
      */
+    get callVoiceChatModel() {
+        if (!this._isVoiceCallingEnabled) {
+            return undefined;
+        }
+        return async (audio, prompt) => {
+            // Ensure we're working with a chat prompt
+            if (prompt.modelRequirements.modelVariant !== 'CHAT') {
+                throw new Error('Agents only supports chat prompts');
+            }
+            const chatPrompt = prompt;
+            const formData = new FormData();
+            formData.append('audio', audio, 'voice.webm');
+            formData.append('message', prompt.content);
+            if (chatPrompt.thread) {
+                formData.append('thread', JSON.stringify(chatPrompt.thread));
+            }
+            const response = await fetch(`${this.agentUrl}/api/voice`, {
+                method: 'POST',
+                body: formData,
+            });
+            if (!response.ok) {
+                throw new Error(`Voice chat failed: ${response.statusText}`);
+            }
+            const result = await response.json();
+            // Convert base64 audio back to Blob
+            const binaryString = atob(result.audio);
+            const bytes = new Uint8Array(binaryString.length);
+            for (let i = 0; i < binaryString.length; i++) {
+                bytes[i] = binaryString.charCodeAt(i);
+            }
+            const audioBlob = new Blob([bytes], { type: 'audio/mp3' });
+            return {
+                text: result.agentMessage || result.text,
+                userMessage: result.userMessage,
+                agentMessage: result.agentMessage || result.text,
+                audio: audioBlob,
+            };
+        };
+    }
     async callChatModelStream(prompt, onProgress) {
         // Ensure we're working with a chat prompt
         if (prompt.modelRequirements.modelVariant !== 'CHAT') {
@@ -18197,70 +18830,6 @@ function migratePipeline(deprecatedPipeline) {
     return migratedPipeline;
 }
 
-/**
- * Function `isValidPipelineString` will validate the if the string is a valid pipeline string
- * It does not check if the string is fully logically correct, but if it is a string that can be a pipeline string or the string looks completely different.
- *
- * @param {string} pipelineString the candidate for a pipeline string
- * @returns {boolean} if the string is a valid pipeline string
- * @public exported from `@promptbook/core`
- */
-function isValidPipelineString(pipelineString) {
-    try {
-        validatePipelineString(pipelineString);
-        return true;
-    }
-    catch (error) {
-        assertsError(error);
-        return false;
-    }
-}
-/**
- * TODO: [🧠][🈴] Where is the best location for this file
- */
-
-/**
- * Tag function for notating a pipeline with a book\`...\ notation as template literal
- *
- * Note: There are 3 similar functions:
- * 1) `prompt` for notating single prompt exported from `@promptbook/utils`
- * 2) `promptTemplate` alias for `prompt`
- * 3) `book` for notating and validating entire books exported from `@promptbook/utils`
- *
- * @param strings The static string parts of the template literal
- * @param values The dynamic values embedded within the template literal used as data
- * @returns the pipeline string
- * @public exported from `@promptbook/core`
- */
-function book(strings, ...values) {
-    const bookString = prompt(strings, ...values);
-    if (!isValidPipelineString(bookString)) {
-        // TODO: Make the CustomError for this
-        throw new Error(spaceTrim$1(`
-                The string is not a valid pipeline string
-
-                book\`
-                    ${bookString}
-                \`
-            `));
-    }
-    if (!isValidBook(bookString)) {
-        // TODO: Make the CustomError for this
-        throw new Error(spaceTrim$1(`
-                The string is not a valid book
-
-                book\`
-                    ${bookString}
-                \`
-            `));
-    }
-    return padBook(bookString);
-}
-/**
- * TODO: [🧠][🈴] Where is the best location for this file
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */
-
 /**
  * Convert identification to Promptbook token
  *
@@ -19023,7 +19592,7 @@ function $generateBookBoilerplate(options) {
     const agentSource = validateBook(spaceTrim$1((block) => `
                 ${agentName}
     
-                META COLOR ${color || '#3498db' /* <- TODO: [🧠] [🐱‍🚀] Best default color */}
+                META COLOR ${color || PROMPTBOOK_COLOR.toHex()}
                 PERSONA ${block(personaDescription)}
             `));
     return agentSource;
@@ -19032,5 +19601,5 @@ function $generateBookBoilerplate(options) {
  * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
  */
 
-export { $bookTranspilersRegister, $generateBookBoilerplate, $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, ADMIN_EMAIL, ADMIN_GITHUB_NAME, API_REQUEST_TIMEOUT, AbstractFormatError, Agent, AgentCollectionInSupabase, AgentLlmExecutionTools, AuthenticationError, BIG_DATASET_TRESHOLD, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateError, BoilerplateFormfactorDefinition, CLAIM, CLI_APP_ID, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CompletionFormfactorDefinition, CsvFormatError, CsvFormatParser, DEFAULT_AGENTS_DIRNAME, DEFAULT_BOOK, DEFAULT_BOOKS_DIRNAME, DEFAULT_BOOK_OUTPUT_PARAMETER_NAME, DEFAULT_BOOK_TITLE, DEFAULT_CSV_SETTINGS, DEFAULT_DOWNLOAD_CACHE_DIRNAME, DEFAULT_EXECUTION_CACHE_DIRNAME, DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_MAX_REQUESTS_PER_MINUTE, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_PROMPT_TASK_TITLE, DEFAULT_REMOTE_SERVER_URL, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TASK_SIMULATED_DURATION_MS, DEFAULT_TASK_TITLE, DatabaseError, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FAILED_VALUE_PLACEHOLDER, FORMFACTOR_DEFINITIONS, FormattedBookInMarkdownTranspiler, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, ImageGeneratorFormfactorDefinition, KnowledgeScrapeError, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_ORDERS, MODEL_TRUST_LEVELS, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NonTaskSectionTypes, NotAllowed, NotFoundError, NotYetImplementedCommitmentDefinition, NotYetImplementedError, ORDER_OF_PIPELINE_JSON, OpenAiSdkTranspiler, PADDING_LINES, PENDING_VALUE_PLACEHOLDER, PLAYGROUND_APP_ID, PROMPTBOOK_CHAT_COLOR, PROMPTBOOK_COLOR, PROMPTBOOK_ENGINE_VERSION, PROMPTBOOK_ERRORS, PROMPTBOOK_LOGO_URL, PROMPTBOOK_SYNTAX_COLORS, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, PromptbookFetchError, REMOTE_SERVER_URLS, RESERVED_PARAMETER_NAMES, RemoteAgent, SET_IS_VERBOSE, SectionTypes, SheetsFormfactorDefinition, TaskTypes, TextFormatParser, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UNCERTAIN_ZERO_VALUE, USER_CHAT_COLOR, UnexpectedError, WrappedError, ZERO_USAGE, ZERO_VALUE, _AgentMetadata, _AgentRegistration, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _BoilerplateScraperMetadataRegistration, _DeepseekMetadataRegistration, _DocumentScraperMetadataRegistration, _GoogleMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _MarkitdownScraperMetadataRegistration, _OllamaMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiCompatibleMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, aboutPromptbookInformation, addUsage, book, cacheLlmTools, compilePipeline, computeAgentHash, computeCosineSimilarity, countUsage, createAgentLlmExecutionTools, createAgentModelRequirements, createAgentModelRequirementsWithCommitments, createBasicAgentModelRequirements, createDefaultAgentName, createEmptyAgentModelRequirements, createLlmToolsFromConfiguration, createPipelineCollectionFromJson, createPipelineCollectionFromPromise, createPipelineCollectionFromUrl, createPipelineExecutor, createPipelineSubcollection, embeddingVectorToString, executionReportJsonToString, extractParameterNamesFromTask, filterModels, generatePlaceholderAgentProfileImageUrl, getAllCommitmentDefinitions, getAllCommitmentTypes, getCommitmentDefinition, getPipelineInterface, getSingleLlmExecutionTools, identificationToPromptbookToken, isCommitmentSupported, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, isValidBook, isValidPipelineString, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, migratePipeline, normalizeAgentName, padBook, parseAgentSource, parseParameters, parsePipeline, pipelineCollectionToJson, pipelineJsonToString, prepareKnowledgePieces, preparePersona, preparePipeline, prettifyPipelineString, promptbookFetch, promptbookTokenToIdentification, unpreparePipeline, usageToHuman, usageToWorktime, validateBook, validatePipeline, validatePipelineString };
+export { $bookTranspilersRegister, $generateBookBoilerplate, $llmToolsMetadataRegister, $llmToolsRegister, $scrapersMetadataRegister, $scrapersRegister, ADMIN_EMAIL, ADMIN_GITHUB_NAME, API_REQUEST_TIMEOUT, AUTO_FEDERATED_AGENT_SERVER_URLS, AbstractFormatError, Agent, AgentCollectionInSupabase, AgentLlmExecutionTools, AuthenticationError, BIG_DATASET_TRESHOLD, BOOK_LANGUAGE_VERSION, BlackholeStorage, BoilerplateError, BoilerplateFormfactorDefinition, CLAIM, CLI_APP_ID, CallbackInterfaceTools, ChatbotFormfactorDefinition, CollectionError, CompletionFormfactorDefinition, CsvFormatError, CsvFormatParser, DEFAULT_AGENTS_DIRNAME, DEFAULT_BOOK, DEFAULT_BOOKS_DIRNAME, DEFAULT_BOOK_OUTPUT_PARAMETER_NAME, DEFAULT_BOOK_TITLE, DEFAULT_CSV_SETTINGS, DEFAULT_DOWNLOAD_CACHE_DIRNAME, DEFAULT_EXECUTION_CACHE_DIRNAME, DEFAULT_GET_PIPELINE_COLLECTION_FUNCTION_NAME, DEFAULT_INTERMEDIATE_FILES_STRATEGY, DEFAULT_IS_AUTO_INSTALLED, DEFAULT_IS_VERBOSE, DEFAULT_MAX_EXECUTION_ATTEMPTS, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH, DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL, DEFAULT_MAX_PARALLEL_COUNT, DEFAULT_MAX_REQUESTS_PER_MINUTE, DEFAULT_PIPELINE_COLLECTION_BASE_FILENAME, DEFAULT_PROMPT_TASK_TITLE, DEFAULT_REMOTE_SERVER_URL, DEFAULT_SCRAPE_CACHE_DIRNAME, DEFAULT_TASK_SIMULATED_DURATION_MS, DEFAULT_TASK_TITLE, DatabaseError, EXPECTATION_UNITS, EnvironmentMismatchError, ExecutionReportStringOptionsDefaults, ExpectError, FAILED_VALUE_PLACEHOLDER, FORMFACTOR_DEFINITIONS, FormattedBookInMarkdownTranspiler, GENERIC_PIPELINE_INTERFACE, GeneratorFormfactorDefinition, GenericFormfactorDefinition, ImageGeneratorFormfactorDefinition, KnowledgeScrapeError, LimitReachedError, MANDATORY_CSV_SETTINGS, MAX_FILENAME_LENGTH, MODEL_ORDERS, MODEL_TRUST_LEVELS, MODEL_VARIANTS, MatcherFormfactorDefinition, MemoryStorage, MissingToolsError, MultipleLlmExecutionTools, NAME, NonTaskSectionTypes, NotAllowed, NotFoundError, NotYetImplementedCommitmentDefinition, NotYetImplementedError, ORDER_OF_PIPELINE_JSON, OpenAiSdkTranspiler, PADDING_LINES, PENDING_VALUE_PLACEHOLDER, PLAYGROUND_APP_ID, PROMPTBOOK_CHAT_COLOR, PROMPTBOOK_COLOR, PROMPTBOOK_ENGINE_VERSION, PROMPTBOOK_ERRORS, PROMPTBOOK_LOGO_URL, PROMPTBOOK_SYNTAX_COLORS, ParseError, PipelineExecutionError, PipelineLogicError, PipelineUrlError, PrefixStorage, PromptbookFetchError, REMOTE_SERVER_URLS, RESERVED_PARAMETER_NAMES, RemoteAgent, SET_IS_VERBOSE, SectionTypes, SheetsFormfactorDefinition, TaskTypes, TextFormatParser, TranslatorFormfactorDefinition, UNCERTAIN_USAGE, UNCERTAIN_ZERO_VALUE, USER_CHAT_COLOR, UnexpectedError, WrappedError, ZERO_USAGE, ZERO_VALUE, _AgentMetadata, _AgentRegistration, _AnthropicClaudeMetadataRegistration, _AzureOpenAiMetadataRegistration, _BoilerplateScraperMetadataRegistration, _DeepseekMetadataRegistration, _DocumentScraperMetadataRegistration, _GoogleMetadataRegistration, _LegacyDocumentScraperMetadataRegistration, _MarkdownScraperMetadataRegistration, _MarkitdownScraperMetadataRegistration, _OllamaMetadataRegistration, _OpenAiAssistantMetadataRegistration, _OpenAiCompatibleMetadataRegistration, _OpenAiMetadataRegistration, _PdfScraperMetadataRegistration, _WebsiteScraperMetadataRegistration, aboutPromptbookInformation, addUsage, book, cacheLlmTools, compilePipeline, computeAgentHash, computeCosineSimilarity, countUsage, createAgentLlmExecutionTools, createAgentModelRequirements, createAgentModelRequirementsWithCommitments, createBasicAgentModelRequirements, createDefaultAgentName, createEmptyAgentModelRequirements, createLlmToolsFromConfiguration, createPipelineCollectionFromJson, createPipelineCollectionFromPromise, createPipelineCollectionFromUrl, createPipelineExecutor, createPipelineSubcollection, embeddingVectorToString, executionReportJsonToString, extractParameterNamesFromTask, filterModels, generatePlaceholderAgentProfileImageUrl, getAllCommitmentDefinitions, getAllCommitmentTypes, getCommitmentDefinition, getGroupedCommitmentDefinitions, getPipelineInterface, getSingleLlmExecutionTools, identificationToPromptbookToken, isCommitmentSupported, isPassingExpectations, isPipelineImplementingInterface, isPipelineInterfacesEqual, isPipelinePrepared, isValidBook, isValidPipelineString, joinLlmExecutionTools, limitTotalUsage, makeKnowledgeSourceHandler, migratePipeline, normalizeAgentName, padBook, parseAgentSource, parseParameters, parsePipeline, pipelineCollectionToJson, pipelineJsonToString, prepareKnowledgePieces, preparePersona, preparePipeline, prettifyPipelineString, promptbookFetch, promptbookTokenToIdentification, unpreparePipeline, usageToHuman, usageToWorktime, validateBook, validatePipeline, validatePipelineString };
 //# sourceMappingURL=index.es.js.map