@promptbook/core 0.103.0-52 → 0.103.0-53

package/umd/index.umd.js

@@ -28,12 +28,23 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-52';
+    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
      *
@@ -55,6 +66,7 @@
             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
         {
@@ -67,7 +79,14 @@
         */
     ];
     /**
-     * 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
      */
 
@@ -8109,6 +8128,77 @@
      * 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$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.
+
+            ## 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
      *
@@ -8273,6 +8363,67 @@
      * 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$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.
+
+            ## 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
      *
@@ -9486,6 +9637,8 @@
         new GoalCommitmentDefinition('GOAL'),
         new GoalCommitmentDefinition('GOALS'),
         new InitialMessageCommitmentDefinition(),
+        new UserMessageCommitmentDefinition(),
+        new AgentMessageCommitmentDefinition(),
         new MessageCommitmentDefinition('MESSAGE'),
         new MessageCommitmentDefinition('MESSAGES'),
         new ScenarioCommitmentDefinition('SCENARIO'),
@@ -9540,6 +9693,45 @@
     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
@@ -10279,6 +10471,18 @@
      * 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$1.spaceTrim(text);
+    }
+
     /**
      * Removes quotes from a string
      *
@@ -10783,7 +10987,96 @@
          * 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
@@ -17212,12 +17505,15 @@
                             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) {
@@ -17306,12 +17602,15 @@
                             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) {
@@ -17685,7 +17984,53 @@
          * 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__default["default"]((block) => `
@@ -17771,6 +18116,70 @@
      * 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__default["default"](`
+                The string is not a valid pipeline string
+
+                book\`
+                    ${bookString}
+                \`
+            `));
+        }
+        if (!isValidBook(bookString)) {
+            // TODO: Make the CustomError for this
+            throw new Error(spaceTrim__default["default"](`
+                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
      *
@@ -17792,11 +18201,12 @@
             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 rxjs.BehaviorSubject(`
-# ${profile.agentName}
+            const agentSource = new rxjs.BehaviorSubject(book `
+            ${profile.agentName}
 
-${profile.personaDescription}
+            ${profile.personaDescription}
         `);
+            // <- TODO: [🐱‍🚀] createBookFromProfile
             // <- TODO: [🐱‍🚀] Support updating and self-updating
             const remoteAgent = new RemoteAgent({
                 ...options,
@@ -17821,10 +18231,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() {
@@ -17840,8 +18252,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') {
@@ -18378,70 +18831,6 @@ ${profile.personaDescription}
         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__default["default"](`
-                The string is not a valid pipeline string
-
-                book\`
-                    ${bookString}
-                \`
-            `));
-        }
-        if (!isValidBook(bookString)) {
-            // TODO: Make the CustomError for this
-            throw new Error(spaceTrim__default["default"](`
-                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
      *
@@ -19204,7 +19593,7 @@ ${profile.personaDescription}
         const agentSource = validateBook(spaceTrim__default["default"]((block) => `
                 ${agentName}
     
-                META COLOR ${color || '#3498db' /* <- TODO: [🧠] [🐱‍🚀] Best default color */}
+                META COLOR ${color || PROMPTBOOK_COLOR.toHex()}
                 PERSONA ${block(personaDescription)}
             `));
         return agentSource;
@@ -19222,6 +19611,7 @@ ${profile.personaDescription}
     exports.ADMIN_EMAIL = ADMIN_EMAIL;
     exports.ADMIN_GITHUB_NAME = ADMIN_GITHUB_NAME;
     exports.API_REQUEST_TIMEOUT = API_REQUEST_TIMEOUT;
+    exports.AUTO_FEDERATED_AGENT_SERVER_URLS = AUTO_FEDERATED_AGENT_SERVER_URLS;
     exports.AbstractFormatError = AbstractFormatError;
     exports.Agent = Agent;
     exports.AgentCollectionInSupabase = AgentCollectionInSupabase;
@@ -19370,6 +19760,7 @@ ${profile.personaDescription}
     exports.getAllCommitmentDefinitions = getAllCommitmentDefinitions;
     exports.getAllCommitmentTypes = getAllCommitmentTypes;
     exports.getCommitmentDefinition = getCommitmentDefinition;
+    exports.getGroupedCommitmentDefinitions = getGroupedCommitmentDefinitions;
     exports.getPipelineInterface = getPipelineInterface;
     exports.getSingleLlmExecutionTools = getSingleLlmExecutionTools;
     exports.identificationToPromptbookToken = identificationToPromptbookToken;